Skip to main content

Issues and comments

Issues​

issue list​

linear-cli issue list [--team KEY] [--assignee ID|me] [--status NAME] [--priority 0-4] [--label NAME] [--limit N] [--cursor CURSOR]

--limit defaults to 50. Team falls back to default_team. Priority values are 0 none, 1 urgent, 2 high, 3 medium, and 4 low. The command returns issue summaries ordered by updatedAt and exposes pagination.hasNextPage and pagination.endCursor.

issue get​

linear-cli issue get ENG-123

The identifier must be TEAM-NUMBER. The result includes the full description, comments, state, assignee, labels, cycle, project, timestamps, and URL.

issue create​

linear-cli issue create --title "Fix login bug" [--team ENG] [--description TEXT|--description-file PATH] [--priority 0-4] [--assignee USER-ID] [--label NAME] [--estimate POINTS] [--cycle CYCLE-ID] [--project PROJECT-ID] [--state STATE-ID]

--title is required. --team is required unless default_team is configured. If both description inputs are supplied, --description-file replaces the flag value. Labels are resolved by name within the resolved team; state, cycle, project, and assignee values are sent as IDs.

issue update​

linear-cli issue update ENG-123 [--title TEXT] [--description TEXT|--description-file PATH] [--priority 0-4] [--assignee USER-ID] [--label NAME] [--estimate POINTS] [--cycle CYCLE-ID] [--project PROJECT-ID] [--status NAME|--state STATE-ID]

At least one field is required. --status resolves a workflow state name; --state sends a state ID directly. If both are present, the direct --state assignment is applied after the name resolution. Only explicitly changed flags are sent.

linear-cli issue search "login error" [--limit N]

--limit defaults to 20. Search matches issue title, description, and comments. The response includes page information, but there is no --cursor flag for requesting another page.

Comments​

comment list​

linear-cli comment list --issue ENG-123

--issue is required. The result contains comment IDs, Markdown bodies, users, and timestamps. This command has no pagination flag.

comment create​

linear-cli comment create --issue ENG-123 --body "This is fixed"
linear-cli comment create --issue ENG-123 --body-file ./review-notes.md

--issue and one non-empty body source are required. --body-file replaces --body when supplied. File read failures are usage errors with exit code 2.