Linear CLI

The linear-cli skill wraps the Linear CLI for managing your Linear workspace entirely from the terminal. It enables full CRUD on issues, projects, teams, cycles, milestones, initiatives, documents, and labels — plus raw GraphQL access for unsupported queries.

Installation

The skill is installed under .pi/agent/skills/linear-cli/. The linear command must be on your PATH:

linear --version

If not installed globally, run it via npx:

npx @schpet/linear-cli --version

What you can do

Issues

• Create, update, view, delete, and query issues
• List your issues, start/stop work, add comments
• Attach links, manage relations, track agent sessions

Projects & teams

• List and view all teams and projects
• Create, update, and delete projects
• View team members and autolinks

Planning

• Manage cycles, milestones, and initiatives
• Create status updates (timeline posts)
• Add/remove projects from initiatives

Advanced

• Raw GraphQL API access with interactive query builder
• Schema introspection for discovering types and fields
• Config file generation (linear config)

Key scripts

The skill ships a handy script for listing all issues across all projects:

script="$HOME/.pi/agent/skills/linear-cli/scripts/list-all-issues.sh"
bash "$script" --json          # all open issues, JSON output
bash "$script" --project "My Pi" --tsv  # single project, TSV

Rate limits

The Linear API has strict rate limits. Always insert sleep 1 between consecutive linear calls.