linear

Query Linear teams, issues, projects, cycles, comments, users and documents. Mirage’s noun/verb interface draws partly on schpet/linear-cli, with its own supported command tree and normalized JSON output for jq.

Setup

Create an API key using Linear setup.

import { LINEAR, Workspace } from '@struktoai/mirage-node'

const config = { apiKey: 'lin_api_...' }
const ws = new Workspace({})
ws.registerCli('linear', LINEAR, config)

No service mount is required. For YAML and multiple accounts, see the CLI overview.

Supported commands

Run linear <command> --help for the supported flags and operands. This list is generated from Mirage’s registered command tree.

Command	Description
`linear team list`	List teams as JSON
`linear team get`	Get one team by key, name, or ID
`linear team members`	List a team’s members
`linear issue list`	List a team’s issues
`linear issue get`	Get one issue by key or ID
`linear issue create`	Create an issue
`linear issue update`	Update an issue’s title or description
`linear issue assign`	Assign an issue to a user
`linear issue transition`	Move an issue to a workflow state
`linear issue set-priority`	Set an issue’s priority
`linear issue set-project`	Attach an issue to a project
`linear issue add-label`	Add a label to an issue
`linear project list`	List a team’s projects
`linear project get`	Get one project by ID
`linear cycle list`	List a team’s cycles
`linear cycle current`	Get a team’s current cycle
`linear cycle get`	Get one cycle by ID
`linear label list`	List a team’s labels
`linear comment list`	List an issue’s comments
`linear comment add`	Comment on an issue
`linear comment update`	Edit a comment
`linear user list`	List workspace users
`linear user get`	Get one user by email
`linear document list`	List a team’s documents
`linear document get`	Get one document by ID
`linear search`	Search issues by text

Find work

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

Issues take a positional key such as ENG-42 or a raw ID. --team accepts a team key, name or ID. Use the list commands to discover project, cycle, label and document IDs.

Update work

linear issue create --team ENG --title "Fix login" --description "Reproduction steps"
linear issue update ENG-42 --title "Fix expired-session login"
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
echo 'Ready for review' | linear comment add ENG-42
linear comment update --comment COMMENT_ID --body "Reviewed"

Value	Accepted forms
Assignee	`--assignee-email` or `--assignee-id`
Workflow state	`--state-name` or `--state-id`
Project	`--project-name` or `--project` with an ID
Label	`--label-name` or `--label` with an ID; preserves existing labels
Priority	`0` none, `1` urgent, `2` high, `3` normal, `4` low

Descriptions and comment bodies can come from stdin. Issue creation requires --team and --title; updates use the values explicitly supplied.

VFS and limits

The Linear VFS lets agents browse the same service as files. The CLI takes service IDs and its own config; piping a mounted file into a body does not make that mount the CLI’s account. Only the commands above are implemented. Commands, flags and JSON output follow this reference; Mirage does not promise full compatibility with schpet/linear-cli. That project uses the ISC license. Mirage’s command implementation is Apache-2.0; see compatibility and licenses.

Getting Started

Access

AI Agents

VFS

CLIs

Runtimes

Setup

Supported commands

Find work

Update work

VFS and limits

​Setup

​Supported commands

​Find work

​Update work

​VFS and limits

Setup

Supported commands

Find work

Update work

VFS and limits