lincli 2026.4.2

Linear CLI — manage issues, projects, cycles, and more from the terminal
lincli-2026.4.2 is not a library.

lin — Linear CLI

CI Crates.io Downloads License: MIT

A fast, native CLI for Linear. Manage issues, projects, cycles, and more from your terminal.

Install

Homebrew (macOS)

brew install aaronkwhite/tap/lin

Cargo

cargo install lincli

Pre-built Binaries

Download from GitHub Releases — available for macOS (Intel & Apple Silicon) and Linux (x86 & ARM).

From Source

git clone https://github.com/aaronkwhite/linear-cli.git
cd linear-cli
cargo install --path .

Setup

Get your API key from Linear Settings > API > Personal API keys, then:

lin config set-token

Or set it via environment variable:

export LINEAR_API_KEY="lin_api_..."

Usage

lin --help                                  # Show all commands
lin issues list --team ENG                  # List issues for a team
lin issues list --state "In Progress"       # Filter by state
lin issues list --label bug --label urgent  # Filter by labels
lin issues get ENG-123                      # Get issue details
lin projects list                           # List projects
lin teams list                              # List teams

Global Flags

Flag Description
--json Output raw JSON for scripting
--debug Print GraphQL queries/responses to stderr
--version Show version

Commands

Group Description
issues List, create, update, search, comment, archive, branch lookup
projects List, create, update, search, archive, delete projects
cycles List, create, manage, archive cycles and cycle issues
initiatives Manage initiatives, status updates, link projects
roadmap Project updates and milestones
labels Create, manage, apply labels
teams List teams, members, states, workload
relations Issue dependencies and relations
customers Customer management, needs, tiers
views Custom views and their issues
docs Documents: create, search, manage
notifications View, read, archive, snooze notifications
me Show authenticated user info
attachments Manage issue attachments and links
search Search across issues, projects, and documents
config Manage API key and CLI configuration
completions Generate shell completions (bash, zsh, fish, powershell)

Why CLI over MCP?

CLI MCP
Tokens per operation ~1,300 ~44,000
Reliability 100% ~72%
Dependencies Single binary Schema injection

Development

cargo build                           # Build
cargo test                            # Run tests (smoke + unit)
LINEAR_API_KEY=... cargo test -- --ignored  # Run integration tests

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

License

MIT