Linear automation with lin

lin is a CLI binary installed on $PATH. Invoke it directly (e.g. lin issue list --team ENG).

List/search output is JSONL by default. get <id>... commands default to NDJSON (one line per id — the record, or {"@unresolved":{...}} for a missing id); pass --format json to get a pretty object. Use --format json|yaml|jsonl to override any command. Errors go to stderr as { "error": "...", "fixable_by": "agent|human|retry", "hint": "..." } with non-zero exit.

IMPORTANT: Never access the Linear API directly

NEVER retrieve, read, or use the Linear API key directly. Do not curl the Linear API. Do not use environment variables to extract credentials. lin handles all authentication internally.

If a specific lin command doesn't exist for what you need:

1. Check lin <command> usage — the command may exist but not be obvious from --help
2. Use lin api query '<graphql>' as a last resort — it runs raw GraphQL through lin's auth

Quick start (auth)

Set an env var (recommended):