linear

Mirage’s built-in client for Linear’s GraphQL API has a Mirage-native noun/verb command grammar partly inspired by schpet/linear-cli. The Mirage command tree is discoverable with linear --help. Licenses: schpet/linear-cli uses the ISC License; Mirage’s independent implementation uses Apache-2.0.

Install

from mirage import Workspace
from mirage.commands.cli.builtin.linear import LINEAR
from mirage.core.linear.config import LinearConfig
from mirage.vfs.linear import LinearVFS

config = LinearConfig(api_key="lin_api_...")
ws = Workspace({"/issues": LinearVFS(config)})
ws.register_cli("linear", LINEAR, config.model_dump())

Two installs under different names are two accounts. In YAML, the same install rides the clis: section; see the CLI overview.

Verbs

The shared shape is linear issue ... and noun groups such as team, user, project, and document. Mirage keeps the exact command tree from its former mount commands (linear issue create, linear team list). Issues are addressed by a positional key or ID (linear issue get ENG-42); every command emits normalized JSON, so output pipes straight into jq.

Reads

linear team list
linear team get ENG
linear team members ENG
linear issue list --team ENG
linear issue get ENG-42
linear project list --team ENG
linear project get <project-id> --team ENG
linear cycle list --team ENG
linear cycle current --team ENG
linear label list --team ENG
linear comment list ENG-42
linear user list
linear user get sam@example.com
linear document list --team ENG
linear document get <document-id> --team ENG
linear search "login bug"

--team accepts a team key, name, or ID.

Writes

linear issue create --team ENG --title "Title" --description "Body"
linear issue update ENG-42 --title "New title"
linear issue assign ENG-42 --assignee-email user@example.com
linear issue transition ENG-42 --state-name "In Review"
linear issue set-priority ENG-42 --priority 2
linear issue set-project ENG-42 --project-name "Search"
linear issue add-label ENG-42 --label-name "bug"
linear comment add ENG-42 --body "comment"
linear comment update --comment <comment-id> --body "edited"

Verb	Notes
`issue create`	`--team` and `--title` required
`issue update`	`--title` and/or `--description`
`issue assign`	`--assignee-email` or `--assignee-id`
`issue transition`	`--state-name` or `--state-id`
`issue set-priority`	`--priority 0..4` (0=none, 1=urgent, … 4=low)
`issue set-project`	`--project-name` or `--project` (ID)
`issue add-label`	`--label-name` or `--label` (ID); appends to the issue’s existing labels

Descriptions and comment bodies also read from stdin: echo "body" | linear comment add ENG-42.

Getting Started

AI Agents

VFS

CLIs

Watch

Runtimes

Install

Verbs

Reads

Writes

​Install

​Verbs

​Reads

​Writes

Install

Verbs

Reads

Writes