Skip to main content

linear-cli

linear-cli is a non-interactive command-line client for Linear. It sends GraphQL requests, prints a predictable JSON envelope, and returns typed process exit codes so shell scripts and AI agents can inspect results without scraping human-oriented output.

The CLI covers authentication, configuration, issues, comments, teams, users, workflow states, labels, projects, cycles, documents, and file attachments. It does not open a prompt or maintain a persistent session.

Start here​

  1. Install linear-cli.
  2. Follow the quick start to verify access and read issues.
  3. Learn the core workflow and JSON contract.
  4. Use the command reference for every command and flag.

For automation, keep credentials out of command arguments when possible and branch on both the JSON error.code and the process exit code. The AI-agent guide shows the safe shell-tool pattern.