Getting Started

First, install linr — the vendor curl | sh installer is the recommended way in, with Homebrew, Cargo, and from-source alternatives on the Install page.

Authenticate

Log in with a personal Linear API key (prompted, or read from LINEAR_API_KEY):

linr auth login --api-key

Check which credential is in effect:

linr auth status

First commands

List the teams in your workspace, then the issues on one:

linr list teams
linr list issues --team ENG

Every command supports --json for agent/programmatic use:

linr auth status --json
linr list issues --team ENG --json

From here, browse the per-area pages — entities, relationships, labels, comments & attachments, reports, and self-update & skills — for the full command surface.