Linear

Linear Issue Management

Interact with Linear.app issues using the linear CLI.

Prerequisites

• linear CLI must be installed (linear --version). If missing, install with:

  curl -fsSL https://raw.githubusercontent.com/lwlee2608/linear-cli/main/install.sh | bash
  

• LINEAR_API_KEY must be set. Check with echo $LINEAR_API_KEY. If unset, tell the user to export it (export LINEAR_API_KEY="lin_api_...").

Commands

Get an issue

linear issue get ENG-123
linear issue get DEV-12 --download-images ./DEV-12-images

Returns: identifier, title, state, team, project, created date, priority, assignee, labels, description.

Use --download-images <directory> to download images embedded in the description. Existing files are not overwritten.

Search issues

linear issue search "login bug"
linear issue search "login bug" --limit 50

Returns a table: ID, TITLE, STATE, ASSIGNEE. Default limit is 20.

Add a comment

linear issue comment ENG-123 "comment body"

Accepts the issue identifier (e.g. ENG-123) or UUID. Prints the comment author and body on success.

Edit a comment

linear issue comment edit <comment-id> "updated body"

Requires the comment UUID, available from Linear's comment URL. Prints the comment author and updated body on success.