linear

What This Skill Does

The Linear skill enables your OpenClaw AI agent to interface directly with the Linear project management platform. By leveraging the linear CLI, this skill allows the agent to create, update, list, and manage issues, projects, teams, and documentation without leaving the command line. It streamlines development workflows by integrating issue tracking with version control (git/jj), enabling features like automated branch creation for specific issues, fetching PR details, and managing project milestones directly through natural language interaction.

Installation

To integrate this skill into your environment, use the OpenClaw installer command: clawhub install openclaw/skills/skills/cipher-shad0w/openclaw-linear

Ensure that the linear CLI tool is installed and authenticated on your system. You can verify this by running linear --version. If it is missing, install it via Homebrew (brew install schpet/tap/linear), Deno, or official binaries from GitHub. Complete the setup by running linear auth login and configuring your repository with linear config inside your project directory.

Use Cases

This skill is ideal for engineering teams looking to reduce context switching between their IDE/terminal and their browser. Use cases include:

• Automated Workflow Management: Instantly move an issue to 'In Progress' and create a git branch when starting a new task.
• Quick Documentation: Upload design specs or requirement documents to specific Linear projects directly from local markdown files.
• Status Reporting: Query your team's current backlog or progress on specific milestones to provide quick updates during standups.
• Rapid Issue Triage: Create and update tickets during active development sessions without needing to navigate the Linear web interface.

Example Prompts

1. "Linear, list all unstarted issues assigned to me and create a new feature branch for the highest priority one."
2. "Update issue ENG-402: mark it as done and add a comment that this was fixed in the latest patch."
3. "List all active projects in the Engineering team and show me the milestones for the Q1 Launch project."

Tips & Limitations

• Prerequisites: Always ensure your local .linear.toml configuration is present in your project root; otherwise, the tool may fail to associate commands with the correct team or workspace.
• Security: Be mindful that this tool authenticates via a personal API key. Treat your environment configuration with the same security level as your git tokens.
• Non-Interactive Mode: Use the non-interactive flags (e.g., -t, -d, -s) when scripting tasks to ensure the agent doesn't hang waiting for user input.