lineark
CLI for the Linear issue tracker — for humans and LLMs.
Part of the lineark project — an unofficial Linear ecosystem for Rust.
Install
Pre-built binary (fastest)
|
Via cargo
Download manually
Grab a binary from the latest release.
Setup
Create a Linear API token and save it:
Or use an environment variable (LINEAR_API_TOKEN) or the --api-token flag.
Usage
Most flags accept human-readable names or UUIDs — --team accepts key/name/UUID, --assignee accepts user name/display name, --labels accepts label names, --project and --cycle accept names.
lineark whoami Show authenticated user
lineark teams list List all teams
lineark users list [--active] List users
lineark projects list List all projects
lineark labels list [--team KEY] List issue labels
lineark cycles list [-l N] [--team KEY] List cycles
[--active] [--around-active N] Active cycle / ± N neighbors
lineark cycles read <ID> [--team KEY] Read cycle (UUID, name, number)
lineark issues list [-l N] [--team KEY] Active issues, newest first
[--mine] [--show-done] Filter by assignee / state
lineark issues read <IDENTIFIER> Full issue detail incl. sub-issues & comments
lineark issues search <QUERY> [-l N] Full-text search
[--team KEY] [--assignee NAME-OR-ID] Filter by team, assignee, status
[--status NAME,...] [--show-done]
lineark issues create <TITLE> --team KEY Create an issue
[-p 0-4] [--assignee NAME-OR-ID] Priority, assignee, labels, status
[--labels NAME,...] [-s NAME] ... Project, cycle — see --help
lineark issues update <IDENTIFIER> Update an issue
[-s NAME] [-p 0-4] [--assignee NAME-OR-ID] Status, priority, assignee
[--clear-parent] [--project NAME-OR-ID] ... See --help for all options
lineark issues archive <IDENTIFIER> Archive an issue
lineark issues unarchive <IDENTIFIER> Unarchive an issue
lineark issues delete <IDENTIFIER> Delete (trash) an issue
lineark comments create <ISSUE-ID> --body TEXT Comment on an issue
lineark documents list [--limit N] List documents (lean output)
[--project NAME-OR-ID] [--issue ID] Filter by project or issue
lineark documents read <ID> Read document (includes content)
lineark documents create --title TEXT Create a document
[--project NAME-OR-ID] [--issue ID]
lineark documents update <ID> Update a document
lineark documents delete <ID> Delete a document
lineark project-milestones list --project NAME List milestones for a project
lineark project-milestones read <ID> Read a milestone
lineark project-milestones create <NAME> Create a milestone
--project NAME-OR-ID [--target-date DATE]
lineark project-milestones update <ID> Update a milestone
lineark project-milestones delete <ID> Delete a milestone
lineark embeds upload <FILE> [--public] Upload file, get asset URL
lineark embeds download <URL> [--output PATH] Download a file by URL
lineark usage Compact command reference
Every command supports --help for full details.
Output format
Output auto-detects: human-readable tables in a terminal, JSON when piped. Override with --format {human,json}.
| LLM / AI agent setup
Add this to your LLM's context (e.g. CLAUDE.md, .cursorrules, system prompt):
We use the `lineark` CLI tool for communicating with Linear. Use your Bash tool
to call the `lineark` executable. Run `lineark usage` to see usage information.
lineark usage gives your agent a complete command reference in under 1,000 tokens.
License
MIT