Linear

Linear CLI

Manage Linear issues from the command line using linear CLI.

Requirements And Safety

• Verify command -v linear, linear --help, and the CLI's authenticated workspace before relying on examples or mutating issues. Do not start login or print an auth token unless the user asks for authentication help.
• Discover team keys, project names, workflow states, and the authenticated user's identity with the installed CLI; do not assume ENG, TC-*, or a fixed assignee.
• Read the target issue before updating it. Search for an existing issue before creating a likely duplicate.
• A request to manage a specific issue authorizes the narrow described update. Confirm before bulk edits, reassignment to another person, destructive operations, or status transitions with material workflow consequences.

Quick Reference

# List issues
linear issue list                    # Your unstarted issues
linear issue list -s started         # Your in-progress issues
linear issue list --all-states       # All your issues
linear issue list -A                 # All assignees
linear issue list --team ENG         # Specific team
linear issue list --project "Q1"     # Filter by project

# View issue
linear issue view TC-123             # View issue details
linear issue view TC-123 --json      # JSON output

# Create issue
linear issue create -t "Title" -d "Description" --team ENG
linear issue create -t "Bug" -l "bug" -a self --priority 1

# Update issue
linear issue update TC-123 -s "In Progress"
linear issue update TC-123 -a self
linear issue update TC-123 --priority 2

# Search (via list filters)
linear issue list --all-states --limit 100 | grep -i "search term"

# Projects & teams
linear project list
linear team list
linear team members

Common Workflows

Find issues by keyword

linear issue list --all-states --all-assignees --limit 100 | grep -i "keyword"

Change issue status

linear issue update TC-123 -s "In Progress"
linear issue update TC-123 -s "Done"

Create and start working

linear issue create -t "New feature" --start

View with comments

linear issue view TC-123              # Includes comments by default
linear issue view TC-123 --no-comments

State Values

• triage - Needs triage
• backlog - Backlog
• unstarted - Todo
• started - In Progress
• completed - Done
• canceled - Canceled

Priority Values

• 1 - Urgent
• 2 - High
• 3 - Medium
• 4 - Low

Direct GraphQL API

For read-only queries not covered by the CLI, use the API directly only when necessary. Prefer CLI mutation commands so their confirmation and validation behavior remains intact.

# Write schema to temp file for reference
linear schema -o /tmp/linear-schema.graphql

# Query with curl
curl -s -X POST https://api.linear.app/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: $(linear auth token)" \
  -d '{"query": "{ viewer { assignedIssues(first: 10) { nodes { identifier title } } } }"}'

Full Command Reference

Run linear --help or linear issue --help for complete options.