linear-cli
linear without leaving the command line: list, start, and create PRs for linear issues. agent friendly.
linear-cli is a command-line interface and agent skill for managing Linear issues, enabling developers and AI agents to list, create, update, and transition issues without leaving the terminal. It integrates with git and jj version control systems to automatically detect current work context from branch names or commit trailers. The tool includes packaged skills for Claude Code and skills.sh that allow AI agents to programmatically interact with Linear's issue tracker, creating issues, updating statuses, managing projects, milestones, and documents alongside code changes.
Key Features
Use Cases
- 01AI agents autonomously creating and triaging Linear issues during code analysis or debugging sessions
- 02Automating issue status updates when starting work on a feature branch
- 03Generating pull requests with Linear issue context pre-populated in title and description
- 04Querying and filtering issues across teams for project planning without context switching
- 05Attaching screenshots or logs to issues directly from terminal workflows
- 06Managing project documentation and milestones programmatically via scripts or agents
Related Skills
View moresuperpowers
An agentic skills framework & software development methodology that works.
skills
Skills for Real Engineers. Straight from my .agents directory.
skills
Public repository for Agent Skills
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
linear-cli — FAQ
What is linear-cli and what does it do?+
linear-cli is a command-line tool and agent skill that manages Linear issues, projects, and documents from the terminal. It includes packaged skills for Claude Code and skills.sh, allowing AI agents to create issues, update statuses, and manage Linear workflows alongside your code.
How do I install the linear-cli skill for Claude Code?+
In Claude Code, run '/plugin marketplace add schpet/linear-cli' followed by '/plugin install linear-cli@linear-cli'. For other AI agents, install via skills.sh with 'npx skills add schpet/linear-cli'.
Which AI clients work with linear-cli?+
linear-cli provides skills for Claude Code (via the plugin system) and any agent compatible with skills.sh. The skill includes instructions for both CLI usage and direct GraphQL API interaction.
Do I need a Linear API key to use linear-cli?+
Yes, you must create a Linear API key at linear.app/settings/account/security and authenticate with 'linear auth login'. API key creation requires member access, not available for guest accounts.
Is linear-cli free to use?+
Yes, linear-cli is open source and free to use. You need a Linear workspace account; the API key feature is available to workspace members.
Does linear-cli work with both git and jj version control?+
Yes, linear-cli supports both git (detecting issue IDs from branch names like 'eng-123-feature') and jj (using Linear-issue trailers in commit descriptions). You can configure which VCS to use via LINEAR_VCS environment variable or the linear.toml config file.
How do I install linear-cli?+
Open the source repository on GitHub and follow its README. linear-cli is a skill — MCP Agents Market links you directly to the official repo.
Is linear-cli free?+
linear-cli is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.