Independent · implementation-labelled reference

Linear CLI commands for real developer workflows.

Search by task, select a command and copy the exact syntax. Each entry explains what the command does, when to use it and what result to expect.

Reference implementation schpet/linear-cli Command syntax may differ between CLI tools.

31 commands available

Command index Select to inspect

Setup

Issues

Git & PR

Workspace

Automation

Confirm that the Linear CLI executable is installed and available in your current shell.

linear --version

Use it when: Use this first after installation or when diagnosing a command-not-found error.
Expected result: Prints the installed Linear CLI version.

Display command groups and global options supported by your installed CLI version.

linear --help

Use it when: Use it when you need to discover syntax directly from the terminal.
Expected result: Prints the built-in command help.

Connect the CLI to a Linear workspace using your API credentials.

linear auth login

Use it when: Run it after installation and before requesting workspace data.
Expected result: Registers credentials for the selected workspace.

Create or update Linear CLI configuration for the current repository.

linear config

Use it when: Use it inside a project repository after authentication.
Expected result: Writes a configuration file containing project or team settings.

Generate command completion support for a compatible terminal shell.

linear completions

Use it when: Use it to improve command discovery and reduce typing errors.
Expected result: Outputs completion instructions or a completion script.

Show your unstarted assigned issues without opening the Linear application.

linear issue mine

Use it when: Use it at the beginning of a work session or before starting a branch.
Expected result: Displays your personal issue queue.

Search issue text inside the configured team using a phrase you provide.

linear issue query --search "login bug"

Use it when: Use it to find existing work before creating a duplicate issue.
Expected result: Returns issues matching the search phrase.

Read a selected issue, description and related context in the terminal.

linear issue view ENG-123

Use it when: Use it when reviewing requirements or checking issue context.
Expected result: Renders terminal-friendly issue details.

Start an issue and create or switch to its connected development branch.

linear issue start ENG-123

Use it when: Use it when you are ready to begin implementation.
Expected result: Connects the issue and branch through the issue identifier.

Create a new issue using a title and description supplied through flags.

linear issue create -t "Fix login timeout" -d "Investigate the API timeout"

Use it when: Use it when capturing new work without leaving the terminal.
Expected result: Creates the issue inside the configured workspace.

Open the update flow for changing issue state, assignment or project context.

linear issue update ENG-123

Use it when: Use it when issue information changes during development.
Expected result: Saves the selected changes to the issue.

Delete a specified issue through the CLI confirmation flow.

linear issue delete ENG-123

Use it when: Use it carefully when an issue was created by mistake.
Expected result: Removes the selected issue after confirmation.

Read the discussion attached to a selected issue.

linear issue comment list ENG-123

Use it when: Use it before replying or when checking review feedback.
Expected result: Displays the issue comment thread.

Start the CLI flow for posting a new comment to an issue.

linear issue comment add ENG-123

Use it when: Use it for progress updates, review notes or implementation context.
Expected result: Adds your comment to the selected issue.

Upload and attach a local file; issue attachments are private by default.

linear issue attach ENG-123 ./screenshot.png

Use it when: Use it when an issue needs a screenshot, specification or supporting file.
Expected result: Adds a workspace-readable attachment to the issue.

Read the issue identifier connected to the current Git branch or jj context.

linear issue id

Use it when: Use it in scripts or when confirming the issue connected to your branch.
Expected result: Prints an identifier such as ENG-123.

Return only the title of the issue detected from the current development context.

linear issue title

Use it when: Use it when generating commit messages, notes or scripts.
Expected result: Prints the current issue title as plain text.

Return the Linear URL for the issue connected to the current branch.

linear issue url

Use it when: Use it when sharing or inserting an issue link into another command.
Expected result: Prints the selected issue URL.

Prepare a GitHub pull request using issue-aware title and body details.

linear issue pr

Use it when: Use it after completing work on an issue-connected branch.
Expected result: Starts the GitHub CLI pull-request flow with Linear context.

List the Linear teams available to the authenticated account.

linear team list

Use it when: Use it when finding a team key for configuration or filters.
Expected result: Displays accessible workspace teams.

Return active and inactive team members as machine-readable JSON.

linear team members --all --json

Use it when: Use it for audits, scripts or assignment workflows.
Expected result: Prints a JSON collection of team members.

List users in the authenticated workspace using structured output.

linear user list --json

Use it when: Use it when resolving users for assignment or automation.
Expected result: Prints workspace user data as JSON.

Show projects accessible within the configured workspace.

linear project list

Use it when: Use it before filtering or creating project-related work.
Expected result: Displays a list of accessible projects.

Open the project selection flow and display details for a selected project.

linear project view

Use it when: Use it when reviewing project context from the terminal.
Expected result: Renders information for the selected project.

List milestones belonging to a specified Linear project.

linear milestone list --project "API v2"

Use it when: Use it when reviewing delivery phases or milestone-related work.
Expected result: Displays milestones for the selected project.

List Linear documents attached to a selected project.

linear document list --project "API v2"

Use it when: Use it when locating specifications, notes or documentation.
Expected result: Displays documents connected to the selected project.

Print raw Markdown content for piping or local processing.

linear document view <slug> --raw

Use it when: Use it when a script or AI agent needs unrendered document content.
Expected result: Outputs document Markdown without terminal rendering.

Query issues across all teams and return the complete result as JSON.

linear issue query --all-teams --json --limit 0

Use it when: Use it for reporting, scripts, processing or AI-agent workflows.
Expected result: Prints machine-readable issue data across accessible teams.

Run a team-scoped search and produce structured output.

linear issue query --search "oauth timeout" --team ENG --json

Use it when: Use it when another process must inspect search results reliably.
Expected result: Returns matching team issues as JSON.

Return accessible Linear projects in structured JSON format.

linear project list --json

Use it when: Use it in scripts that need project identifiers or metadata.
Expected result: Prints machine-readable project data.

Add implementation-provided Linear CLI guidance for compatible coding agents.

npx skills add schpet/linear-cli

Use it when: Use it when an AI agent needs structured Linear workflow instructions.
Expected result: Installs the CLI skill into the supported agent environment.

JavaScript is required for interactive command selection. You can still use linear --help in your terminal.

Before you run a command

Quick answers that prevent common mistakes.

Which command lists issues assigned to me?

Use linear issue mine. It displays your unstarted assigned issues and provides a practical starting point for choosing your next task.

How do I search Linear issues from the terminal?

Use linear issue query with the --search option. Add --team for a team-scoped query or --json for machine-readable output.

Can Linear CLI commands return JSON?

Yes. Commands that support --json can provide structured output for scripts, reports and AI-agent workflows.

Are these commands part of an official Linear CLI?

Linear CLI is a general search term and syntax can vary between tools. This independent page labels commands for the schpet/linear-cli implementation.