Manage Linear issues from the command line using the linear cli. This skill allows automating linear management.
The `linear-cli` skill provides a command-line interface for managing issues, projects, teams, and other resources within Linear. It allows users to interact with Linear directly from the terminal, streamlining workflows that would otherwise require navigating the web interface. By enabling automation and scripting, this skill helps development teams manage tasks more efficiently, maintain consistent issue tracking, and integrate Linear operations into existing CI/CD pipelines or development environments.
Key features of `linear-cli` include full authentication management, issue creation, updating, commenting, and deletion, as well as project, team, milestone, cycle, initiative, label, and document management. It supports file-based flags for markdown content to ensure proper formatting and prevent common shell escaping issues. Users can perform queries, link issues, manage relations, and interact with agent sessions. Additionally, the CLI supports integration with `git` and `jj`, providing a seamless connection between version control and issue management.
This skill is ideal for software developers, project managers, and DevOps engineers who prefer terminal-based workflows or need to automate repetitive Linear tasks. Typical use cases include creating issues from scripts, updating multiple issues programmatically, adding detailed markdown comments, querying and viewing project metrics, and managing team resources without leaving the command line. Organizations seeking to standardize issue tracking and enhance developer productivity will find `linear-cli` particularly beneficial.
You can run it without global installation using npx: `npx @schpet/linear-cli --version`. Subsequent commands can also be prefixed with `npx @schpet/linear-cli`.
It's recommended to use file-based flags like `--description-file` or `--body-file` for multi-line or complex markdown content to ensure proper formatting and avoid shell escaping issues.
The `linear` command must be available on your PATH. You can verify this with `linear --version`. If not installed, you can use it via npx or follow the official installation instructions on GitHub.
linear-cli runs wherever Node.js and Bash are available, supporting cross-platform usage via npx or global installation.
Inline flags like `--description` or `--body` should only be used for simple, single-line content. Multi-line or complex markdown should always use file-based flags.
Quick Setup:
.claude/skills/Repository
schpet/linear-cli