terminal

cmdhub adapter

Linear CLI
for cmdhub.

Linear resources through the cmdhub CLI.

lock Auth: api_key

Quick Install cmdhub get linear

data_object Agent Contract

Agents should start with auth/status and discovery commands, inspect schemas before composition, and treat commands marked as mutating as state-changing operations.

catalog.json Markdown

Output

Use human output for reading, `--json` for one object, and `--jsonl` for pipes.

Auth

Linear OAuth or API key. Used for Linear workspaces, teams, users, states, cycles, labels, projects, issues, and comments.

Refs

Prefer list/search, then short refs or piped JSONL. Use `resolve` to inspect cached refs.

Schemas

Use `linear schema` and `catalog.json` to inspect fields, flags, examples, and side effects.

Auth scopes

Linear workspace API access

terminal Command Reference

Generated from source. Global flags apply to all commands.

Global Flags

--json bool Emit JSON machine output

--jsonl bool Emit JSONL records for piping

--output, -o string Compatibility output mode: json|jsonl. Prefer --json or --jsonl

--view string = summary View mode: summary|full

--profile string = default Config/auth profile

--config string Config path override

--quiet, -q bool Suppress non-essential diagnostics

--debug bool Enable debug diagnostics

--limit int = 50 Maximum items to emit

--page-size int = 50 Requested upstream page size

--cursor string Continuation cursor

--no-paginate bool Fetch only one page

--version, -v bool Print version information

linear attachment Manage Linear attachment records

#cmd-linear-attachment discovery safe

linear attachment create Create a Linear external URL attachment

#cmd-linear-attachment-create mutates state

--issue string Issue ref, identifier, URL, or ID

--metadata-json string Attachment metadata JSON object

--subtitle string Attachment subtitle

--title string Attachment title

--url string External URL to attach

$ linear attachment create --help

$ linear attachment create --issue i1 --url https://example.com/logs --title "Logs"

linear attachment delete Delete a Linear external URL attachment

#cmd-linear-attachment-delete mutates state dry-run

--dry-run bool Preview without changing Linear state

--yes bool Confirm attachment deletion

$ linear attachment delete a1 --yes

linear attachment get Get a Linear attachment

#cmd-linear-attachment-get discovery safe

$ linear attachment get a1

linear attachment list List Linear attachment records

#cmd-linear-attachment-list discovery safe

--include-archived bool Include archived Linear records

--issue string Issue ref, identifier, URL, or ID

$ linear attachment list

$ linear attachment list --issue CMD-123

linear attachment update Update a Linear external URL attachment

#cmd-linear-attachment-update mutates state

--metadata-json string Attachment metadata JSON object

--subtitle string Attachment subtitle

--title string Attachment title

$ linear attachment update a1 --title "Updated logs"

linear auth Manage Linear authentication

#cmd-linear-auth discovery safe

linear auth login Authenticate with Linear

#cmd-linear-auth-login mutates state

--api-key bool authenticate with a Linear personal API key instead of OAuth

--api-key-stdin bool read the Linear API key from stdin

$ linear auth login

$ linear auth login --api-key

$ linear auth login --help

$ linear auth status

linear auth logout Remove stored Linear credentials

#cmd-linear-auth-logout mutates state

$ linear auth login

$ linear auth logout

$ linear auth logout --help

linear auth refresh Refresh stored Linear credentials

#cmd-linear-auth-refresh mutates state

$ linear auth refresh

$ linear auth refresh --help

linear auth status Show Linear auth status

#cmd-linear-auth-status discovery safe

$ linear auth status

$ linear auth status --help

$ linear auth status --json

linear auth whoami Show the current Linear user and workspace

#cmd-linear-auth-whoami discovery safe

$ linear auth whoami

$ linear auth whoami --help

$ linear auth whoami --json

linear capabilities Describe capabilities

#cmd-linear-capabilities discovery safe

$ linear capabilities --help

linear comment Manage Linear comment records

#cmd-linear-comment mutates state

linear comment create Create a Linear issue comment

#cmd-linear-comment-create mutates state

--body string Comment markdown body

--body-file string Read comment body from a file

--issue string Issue ref, identifier, URL, or ID

$ linear comment create --help

$ linear comment create --issue i1 --body "Reproduced in staging."

linear comment delete Delete a Linear issue comment

#cmd-linear-comment-delete mutates state dry-run

--dry-run bool Preview without changing Linear state

--yes bool Confirm comment deletion

$ linear comment delete cm1 --yes

linear comment get Get a Linear comment

#cmd-linear-comment-get discovery safe

$ linear comment get cm1

linear comment list List Linear comment records

#cmd-linear-comment-list discovery safe

--include-archived bool Include archived Linear records

--issue string Issue ref, identifier, URL, or ID

$ linear comment list

$ linear comment list --issue CMD-123

linear comment update Update a Linear issue comment

#cmd-linear-comment-update mutates state

--body string Comment markdown body

--body-file string Read comment body from a file

$ linear comment update cm1 --body "Updated comment."

linear config Inspect local configuration

#cmd-linear-config discovery safe

linear config explain Explain resolved configuration

#cmd-linear-config-explain discovery safe

$ linear config explain --help

linear cycle Manage Linear cycle records

#cmd-linear-cycle discovery safe

linear cycle get Get a Linear cycle

#cmd-linear-cycle-get discovery safe

$ linear cycle get cy1

linear cycle list List Linear cycle records

#cmd-linear-cycle-list discovery safe

--include-archived bool Include archived Linear records

--team string Team ref, key, name, or ID

$ linear cycle list

$ linear cycle list --team CMD

linear doctor Run diagnostics

#cmd-linear-doctor discovery safe

$ linear doctor --help

linear issue Manage Linear issue records

#cmd-linear-issue discovery safe

linear issue archive Archive a Linear issue

#cmd-linear-issue-archive mutates state dry-run

--dry-run bool Preview without changing Linear state

--yes bool Confirm the issue archive operation

$ linear issue archive i1 --yes

linear issue create Create a Linear issue

#cmd-linear-issue-create mutates state

--assignee string Assignee user ref, email, name, ID, or me

--cycle string Cycle ref, number, name, or ID

--description string Issue markdown description

--description-file string Read issue markdown description from a file

--due-date string Due date in YYYY-MM-DD form

--label stringArray = [] Issue label ref, name, or ID; repeatable

--priority string Priority: none, urgent, high, medium, low, or 0-4

--project string Project ref, slug, name, or ID

--state string Workflow state ref, name, or ID

--team string Team ref, key, name, or ID

--title string Issue title

$ linear issue create --help

$ linear issue create --team CMD --title "Investigate login error"

linear issue get Get a Linear issue

#cmd-linear-issue-get discovery safe

$ linear issue get CMD-123

linear issue label Manage labels on Linear issues

#cmd-linear-issue-label mutates state

linear issue label add Add a label on a Linear issue

#cmd-linear-issue-label-add mutates state

--label string Label ref, name, or ID

$ linear issue label add i1 --label cmdhub-demo

linear issue label remove Remove a label on a Linear issue

#cmd-linear-issue-label-remove mutates state

--label string Label ref, name, or ID

$ linear issue label remove i1 --label cmdhub-demo

linear issue list List Linear issue records

#cmd-linear-issue-list discovery safe

--assignee string Assignee user ref, email, name, ID, or me

--created-after string Only include issues created after this date or RFC3339 timestamp

--creator string Creator user ref, email, name, ID, or me

--cycle string Cycle ref, number, name, or ID

--due-after string Only include issues due on or after this YYYY-MM-DD date

--due-before string Only include issues due on or before this YYYY-MM-DD date

--include-archived bool Include archived Linear records

--label string Issue label ref, name, or ID

--priority string Priority: none, urgent, high, medium, low, or 0-4

--project string Project ref, slug, name, or ID

--state string Workflow state ref, name, or ID

--state-type string Workflow state type such as backlog, unstarted, started, completed, or canceled

--team string Team ref, key, name, or ID

--updated-after string Only include issues updated after this date or RFC3339 timestamp

$ linear issue list

$ linear issue list --limit 20

linear issue search Search Linear issue records

#cmd-linear-issue-search discovery safe

--assignee string Assignee user ref, email, name, ID, or me

--created-after string Only include issues created after this date or RFC3339 timestamp

--creator string Creator user ref, email, name, ID, or me

--cycle string Cycle ref, number, name, or ID

--due-after string Only include issues due on or after this YYYY-MM-DD date

--due-before string Only include issues due on or before this YYYY-MM-DD date

--include-archived bool Include archived Linear records

--label string Issue label ref, name, or ID

--priority string Priority: none, urgent, high, medium, low, or 0-4

--project string Project ref, slug, name, or ID

--query string Search text

--state string Workflow state ref, name, or ID

--state-type string Workflow state type such as backlog, unstarted, started, completed, or canceled

--team string Team ref, key, name, or ID

--updated-after string Only include issues updated after this date or RFC3339 timestamp

$ linear issue search

$ linear issue search --query login

linear issue unarchive Unarchive a Linear issue

#cmd-linear-issue-unarchive mutates state dry-run

--dry-run bool Preview without changing Linear state

--yes bool Confirm the issue unarchive operation

$ linear issue unarchive i1 --yes

linear issue update Update a Linear issue

#cmd-linear-issue-update mutates state

--assignee string Assignee user ref, email, name, ID, or me

--clear-assignee bool Remove issue assignee

--clear-cycle bool Remove issue cycle

--clear-due-date bool Remove issue due date

--clear-project bool Remove issue project

--cycle string Cycle ref, number, name, or ID

--description string Issue markdown description

--description-file string Read issue markdown description from a file

--due-date string Due date in YYYY-MM-DD form

--priority string Priority: none, urgent, high, medium, low, or 0-4

--project string Project ref, slug, name, or ID

--state string Workflow state ref, name, or ID

--title string Issue title

$ linear issue update i1 --state "In Progress"

$ linear issue update i1 --title "Updated title"

linear label Manage Linear label records

#cmd-linear-label mutates state

linear label get Get a Linear label

#cmd-linear-label-get discovery safe

$ linear label get l1

linear label list List Linear label records

#cmd-linear-label-list discovery safe

--include-archived bool Include archived Linear records

--team string Team ref, key, name, or ID

$ linear label list

$ linear label list --team CMD

linear logout Remove stored Linear credentials

#cmd-linear-logout mutates state

$ linear auth login

$ linear logout

linear profile Manage provider profiles

#cmd-linear-profile discovery safe

linear profile create Create an unauthenticated provider profile

#cmd-linear-profile-create mutates state

$ linear profile create --help

linear profile delete Delete a local provider profile

#cmd-linear-profile-delete mutates state

$ linear profile delete --help

linear profile list List provider profiles

#cmd-linear-profile-list discovery safe

$ linear profile list --help

linear profile rename Rename a local provider profile

#cmd-linear-profile-rename discovery safe

$ linear profile rename --help

linear profile use Set the default provider profile

#cmd-linear-profile-use mutates state

$ linear profile use --help

linear project Manage Linear project records

#cmd-linear-project discovery safe

linear project get Get a Linear project

#cmd-linear-project-get discovery safe

$ linear project get p1

linear project list List Linear project records

#cmd-linear-project-list discovery safe

--include-archived bool Include archived Linear records

$ linear project list

$ linear project list --limit 10

linear project search Search Linear project records

#cmd-linear-project-search discovery safe

--include-archived bool Include archived Linear records

--query string Search text

$ linear project search

$ linear project search --query onboarding

linear resolve Resolve a local ref, short id, or URL alias

#cmd-linear-resolve discovery safe

$ linear resolve --help

$ linear resolve <ref>

linear schema Emit schema hints

#cmd-linear-schema discovery safe

--in bool Show input schema

--input bool Show input schema

--out bool Show output schema

$ linear schema --help

linear state Manage Linear state records

#cmd-linear-state discovery safe

linear state get Get a Linear state

#cmd-linear-state-get discovery safe

$ linear state get s1

linear state list List Linear state records

#cmd-linear-state-list discovery safe

--include-archived bool Include archived Linear records

--team string Team ref, key, name, or ID

$ linear state list

$ linear state list --team CMD

linear team Manage Linear team records

#cmd-linear-team discovery safe

linear team get Get a Linear team

#cmd-linear-team-get discovery safe

$ linear team get t1

linear team list List Linear team records

#cmd-linear-team-list discovery safe

--include-archived bool Include archived Linear records

$ linear team list

$ linear team list --limit 10

linear team search Search Linear team records

#cmd-linear-team-search discovery safe

--include-archived bool Include archived Linear records

--query string Search text

$ linear team search

$ linear team search --query platform

linear user Manage Linear user records

#cmd-linear-user discovery safe

linear user get Get a Linear user

#cmd-linear-user-get discovery safe

$ linear user get u1

linear user list List Linear user records

#cmd-linear-user-list discovery safe

--include-archived bool Include archived Linear records

$ linear user list

$ linear user list --limit 10

linear user search Search Linear user records

#cmd-linear-user-search discovery safe

--include-archived bool Include archived Linear records

--query string Search text

$ linear user search

$ linear user search --query alice

linear version Show version information

#cmd-linear-version discovery safe

$ linear version --help

play_circle Live Examples

Output captured from a real workspace. Regenerate with scripts/gen-docs.sh --update.

auth

Show auth status Shows the current auth state and next step.

$ linear auth status

Authenticated as kestrelphilip@gmail.com

Next steps:
- Issues:       linear issue list --limit 10
- Teams:        linear team list --limit 10
- Doctor:       linear doctor
- Capabilities: linear capabilities

lifecycle

Show capabilities Lists command surfaces and output modes.

$ linear capabilities

linear capabilities
Resources: attachment, auth, capabilities, comment, config, cycle, doctor, issue, issue_label, label, profile, project, resolve, schema, state, team, user, version
Machine output: --json, --jsonl
Required scopes: comments:create, issues:create, read, write

Next steps:
- Scopes:   linear capabilities --section scopes
- Schema:   linear schema
- Contract: linear capabilities --json
- Help:     linear --help

schemas

Show schema overview Lists available schemas.

$ linear schema

linear schemas
COMMAND                DIR
user.list              output
user.search            input
issue.list             output
issue.archive          output
comment.create         output
issue.archive          input
issue.unarchive        input
comment.update         input
state.get              output
label.get              input
comment.get            output
comment.delete         output
cycle.get              output
project.list           input
project.search         output
issue_label.remove     output
attachment.delete      output
label.list             input
project.get            input
attachment.update      output
comment.create         input
auth.login             output
issue.update           input
attachment.delete      input
label.list             output
issue.list             input
issue.search           output
issue.create           input
auth.refresh           output
resolve.get            output
user.list              input
state.list             output
issue.get              input
attachment.list        output
capabilities.describe  output
issue.create           output
issue_label.add        output
comment.list           input
comment.list           output
comment.update         output
attachment.update      input
auth.status            output
user.get               output
issue.update           output
attachment.list        input
attachment.get         input
user.search            output
cycle.list             output
project.list           output
attachment.create      output
cycle.list             input
issue.search           input
auth.logout            output
team.get               input
label.get              output
cycle.get              input
issue.get              output
team.list              output
state.get              input
project.search         input
comment.get            input
issue_label.add        input
team.list              input
project.get            output
issue.unarchive        output
attachment.create      input
auth.whoami            output
team.search            input
state.list             input
attachment.get         output
comment.delete         input
doctor.run             output
version.get            output
team.search            output
team.get               output
user.get               input
issue_label.remove     input

Next steps:
- Issues:       linear issue list --limit 10
- Teams:        linear team list --limit 10
- Doctor:       linear doctor
- Capabilities: linear capabilities

alt_route Composition Patterns

Bridge your ecosystem with zero middleware.

# Inspect auth state and available command schemas
linear auth status --json
linear schema

Linear CLIfor cmdhub.

data_object Agent Contract

Output

Auth

Refs

Schemas

Auth scopes

terminal Command Reference

Global Flags

play_circle Live Examples

auth

lifecycle

schemas

alt_route Composition Patterns

Linear CLI
for cmdhub.