linear

Query and manage Linear issues, projects, cycles, teams, and labels.

The linear command supports direct scripting operations and clanker linear ask for natural-language project and triage questions.

Usage

clanker linear [command]

Alias: lin

Authentication

linear:
  api_key: ""
  workspace_id: ""
  default_team: ""

Environment variables:

Variable	Description
LINEAR_API_KEY	Linear Personal API Key
LINEAR_WORKSPACE_ID	Optional workspace UUID
LINEAR_TEAM	Optional default team key, for example ENG

Linear expects the raw API key in the authorization header. Do not prefix it with Bearer.

Commands

Command	Description
ask	Ask natural-language questions about your Linear workspace
list	List issues, projects, cycles, teams, labels, users, or workspaces
get	Get a single resource by ID or issue identifier
create	Create issues, projects, and cycles
update	Update issues and projects
resolve	Move issues to the first completed-type state for their team
assign	Assign an issue to a user
comment	Post a comment on an issue
label	Manage issue labels

Examples

clanker linear list issues --team ENG --state started
clanker linear list cycles --team ENG --active
clanker linear get issue ENG-42
clanker linear create issue --team-id <team-uuid> --title "Fix prod alert"
clanker linear comment ENG-42 "Investigating with Clanker"

Natural-language work triage:

clanker linear ask "what is on my plate this cycle?"
clanker linear ask "what projects are blocked?"
clanker linear ask "are there unresolved bugs in auth-rewrite?" --team ENG

Infrastructure Labels

For Clanker Cloud resource drawers and infra-linked work, use labels in this shape:

infra:<type>:<id>

Example:

clanker linear label create infra:lambda:arn:aws:lambda:us-east-1:123:function:api <team-id>

The app can then find work connected to a cloud resource without scraping issue text.

MCP

The MCP server exposes Linear tools for ask, issue/project/cycle/team listing, issue/project create/update, comments, and label search. See mcp.