# Docs


- **Getting Started**
- [Introduction](/): The Linear CLI for humans and AI agents - one fast native binary over the Linear API.
- [Installation](/installation): Install lin via Homebrew, go install, or from a clone.
- [Authentication](/authentication): Authenticate lin with a Linear personal API key, stored in named profiles.
- [Quickstart](/quickstart): Your first lin commands and the grammar that shapes all of them.

- **Reference**
- Commands
  - [Command reference](/commands): Every lin command, grouped by resource.
  - [lin agent](/commands/agent): Inspect Linear agent sessions and activities
  - [lin attachment](/commands/attachment): Upload files and manage issue attachments
  - [lin audit](/commands/audit): Read the organization audit log (admin only)
  - [lin auth](/commands/auth): Store and manage Linear API keys as named profiles
  - [lin comment](/commands/comment): Add and manage issue comments
  - [lin custom-view](/commands/custom-view): Manage custom views
  - [lin customer-need](/commands/customer-need): Create, inspect and manage customer needs
  - [lin customer-status](/commands/customer-status): Manage customer-status values
  - [lin customer-tier](/commands/customer-tier): Manage customer-tier values
  - [lin customer](/commands/customer): Create, inspect and manage customers
  - [lin cycle](/commands/cycle): Inspect and manage cycles
  - [lin describe](/commands/describe): Emit the command surface as JSON so agents introspect instead of parsing --help
  - [lin document](/commands/document): Create, inspect and manage documents
  - [lin emoji](/commands/emoji): Manage custom workspace emojis
  - [lin external-link](/commands/external-link): Manage external links pinned on entities
  - [lin favorite](/commands/favorite): Manage the viewer's favorites
  - [lin initiative-label](/commands/initiative-label): Manage initiative labels
  - [lin initiative](/commands/initiative): Create, inspect and manage initiatives
  - [lin issue](/commands/issue): Create, inspect and manage issues
  - [lin label](/commands/label): List and manage issue labels
  - [lin milestone](/commands/milestone): Create, inspect and manage project milestones
  - [lin notification](/commands/notification): Manage the viewer's notification inbox
  - [lin org](/commands/org): Inspect and administer the organization
  - [lin project-label](/commands/project-label): Manage project labels
  - [lin project-status](/commands/project-status): Manage workspace project statuses
  - [lin project](/commands/project): Create, inspect and manage projects
  - [lin reaction](/commands/reaction): Add and remove emoji reactions
  - [lin release-note](/commands/release-note): Create and inspect release notes
  - [lin release-pipeline](/commands/release-pipeline): List release pipelines
  - [lin release-stage](/commands/release-stage): Manage release stages
  - [lin release](/commands/release): Create and inspect releases
  - [lin schedule](/commands/schedule): Manage time schedules (used by triage responsibilities)
  - [lin state](/commands/state): Inspect and manage workflow states (issue statuses)
  - [lin status-update](/commands/status-update): Post and read project / initiative status updates
  - [lin team](/commands/team): Inspect and manage teams
  - [lin template](/commands/template): Manage issue, project and document templates
  - [lin triage](/commands/triage): Manage team triage responsibilities
  - [lin user](/commands/user): Inspect and manage workspace users
  - [lin version](/commands/version): Show version, commit and build date
  - [lin webhook](/commands/webhook): Manage workspace webhooks
  - [lin whoami](/commands/whoami): Show the authenticated user and organization
- [Exit codes and global flags](/reference): The cross-cutting contract every lin command honors.
- [Agents](/agents): How an AI agent should drive lin - the invariants that help text cannot enforce.