linearQuery and manage Linear issues, projects, and team workflows.
Install via ClawdBot CLI:
clawdbot install ManuelHettich/linearManage issues, check project status, and stay on top of your team's work.
export LINEAR_API_KEY="your-api-key"
# Optional: default team key used when a command needs a team
export LINEAR_DEFAULT_TEAM="TEAM"Discover team keys:
{baseDir}/scripts/linear.sh teamsIf LINEAR_DEFAULT_TEAM is set, you can omit the team key in team and call:
{baseDir}/scripts/linear.sh create "Title" ["Description"]# My stuff
{baseDir}/scripts/linear.sh my-issues # Your assigned issues
{baseDir}/scripts/linear.sh my-todos # Just your Todo items
{baseDir}/scripts/linear.sh urgent # Urgent/High priority across team
# Browse
{baseDir}/scripts/linear.sh teams # List available teams
{baseDir}/scripts/linear.sh team <TEAM_KEY> # All issues for a team
{baseDir}/scripts/linear.sh project <name> # Issues in a project
{baseDir}/scripts/linear.sh issue <TEAM-123> # Get issue details
{baseDir}/scripts/linear.sh branch <TEAM-123> # Get branch name for GitHub
# Actions
{baseDir}/scripts/linear.sh create <TEAM_KEY> "Title" ["Description"]
{baseDir}/scripts/linear.sh comment <TEAM-123> "Comment text"
{baseDir}/scripts/linear.sh status <TEAM-123> <todo|progress|review|done|blocked>
{baseDir}/scripts/linear.sh assign <TEAM-123> <userName>
{baseDir}/scripts/linear.sh priority <TEAM-123> <urgent|high|medium|low|none>
# Overview
{baseDir}/scripts/linear.sh standup # Daily standup summary
{baseDir}/scripts/linear.sh projects # All projects with progress{baseDir}/scripts/linear.sh standupShows: your todos, blocked items across team, recently completed, what's in review.
{baseDir}/scripts/linear.sh create TEAM "Fix auth timeout bug" "Users getting logged out after 5 min"{baseDir}/scripts/linear.sh urgent # See what needs attentionAlways use Linear-derived branch names to enable automatic issue status tracking.
{baseDir}/scripts/linear.sh branch TEAM-212
# Returns: dev/team-212-fix-auth-timeout-bug# 1. Get the branch name from Linear
BRANCH=$({baseDir}/scripts/linear.sh branch TEAM-212)
# 2. Pull fresh main first (main should ALWAYS match origin)
cd /path/to/repo
git checkout main && git pull origin main
# 3. Create worktree with that branch (branching from fresh origin/main)
git worktree add .worktrees/team-212 -b "$BRANCH" origin/main
cd .worktrees/team-212
# 4. Do your work, commit, push
git push -u origin "$BRANCH"⚠️ Never modify files on main. All changes happen in worktrees only.
# Full workflow example
ISSUE="TEAM-212"
BRANCH=$({baseDir}/scripts/linear.sh branch $ISSUE)
# Always start from fresh main
cd ~/workspace/your-repo
git checkout main && git pull origin main
# Create worktree (inside .worktrees/)
git worktree add .worktrees/${ISSUE,,} -b "$BRANCH" origin/main
cd .worktrees/${ISSUE,,}
# ... make changes ...
git add -A && git commit -m "fix: implement $ISSUE"
git push -u origin "$BRANCH"
gh pr create --title "$ISSUE: <title>" --body "Closes $ISSUE"| Level | Value | Use for |
|-------|-------|---------|
| urgent | 1 | Production issues, blockers |
| high | 2 | This week, important |
| medium | 3 | This sprint/cycle |
| low | 4 | Nice to have |
| none | 0 | Backlog, someday |
Team keys and IDs are discovered via the API and cached locally after the first lookup.
Use linear.sh teams to refresh and list available teams.
LINEAR_API_KEY env varTEAM-123Inspired by schpet/linear-cli by Peter Schilling (ISC License).
This is an independent bash implementation for Clawdbot integration.
Generated Feb 23, 2026
A development team uses the Linear skill to track daily standups, assign tasks, and monitor project progress. They automate issue creation from chat and use branch naming for GitHub integration, ensuring seamless status updates as PRs are created and merged.
A product management team employs the skill to prioritize urgent bugs and feature requests across multiple projects. They quickly filter high-priority issues, assign them to developers, and update statuses to maintain workflow efficiency during rapid release cycles.
Distributed teams leverage the Linear skill to centralize issue tracking and project oversight. By using commands like 'my-issues' and 'standup', team members stay aligned on tasks, reduce communication overhead, and ensure accountability in asynchronous work environments.
DevOps engineers integrate Linear with GitHub workflows to automate issue status transitions. They use the skill to generate branch names from issues, trigger PR reviews, and track deployments, enhancing pipeline visibility and reducing manual updates.
A company offers the Linear skill as part of a premium AI agent package, charging monthly fees for enhanced project management features. Revenue is generated through tiered subscriptions based on usage limits, team size, and integration capabilities.
The skill is provided for free with basic issue tracking, while advanced features like automated GitHub integration, priority support, and custom workflows are monetized. Upsells target larger teams needing scalability and deeper analytics.
Organizations license the Linear skill for internal use across departments, with custom integrations, dedicated support, and compliance features. Revenue comes from annual contracts tailored to enterprise needs, such as security audits and API rate limits.
💬 Integration Tip
Set LINEAR_API_KEY and LINEAR_DEFAULT_TEAM environment variables to streamline commands, and use the branch naming feature to automate GitHub issue tracking for efficient workflows.
Manage Trello boards, lists, and cards via the Trello REST API.
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
Manage tasks and projects in Todoist. Use when user asks about tasks, to-dos, reminders, or productivity.
Master OpenClaw's timing systems. Use for scheduling reliable reminders, setting up periodic maintenance (janitor jobs), and understanding when to use Cron v...
Calendar management and scheduling. Create events, manage meetings, and sync across calendar providers.
Kanban-style task management dashboard for AI assistants. Manage tasks via CLI or dashboard UI. Use when user mentions tasks, kanban, task board, mission con...