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)

curl -fsSL https://raw.githubusercontent.com/flipbit03/lineark/main/install.sh | sh

Via cargo

cargo install lineark

Download manually

Grab a binary from the latest release.

Setup

Create a Linear API token and save it:

echo "lin_api_..." > ~/.linear_api_token

Or use an environment variable (LINEAR_API_TOKEN) or the --api-token flag.

Usage

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                              List issue labels
lineark cycles list [--limit 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 [--limit N] [--team KEY]     Active issues, newest first
  [--mine] [--show-done]                         Filter by assignee / state
lineark issues read <IDENTIFIER>                 Full issue detail (e.g., E-929)
lineark issues search <QUERY> [--limit N]        Full-text search
  [--show-done]                                  Include done/canceled results
lineark issues create <TITLE> --team KEY         Create an issue
  [--priority 0-4] [--status NAME] ...           See --help for all options
lineark issues update <IDENTIFIER>               Update an issue
  [--status NAME] [--priority 0-4] ...           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
lineark documents read <ID>                      Read document (includes content)
lineark documents create --title TEXT             Create a document
lineark documents update <ID>                    Update a document
lineark documents delete <ID>                    Delete a document
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}.

lineark teams list                  # table in terminal
lineark teams list | jq .           # JSON when piped
lineark teams list --format json    # force 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