Linear Agent CLI

Agent-first Linear CLI + TUI built with TypeScript, pnpm, Turborepo, the Linear SDK, Biome, and Vitest.

Tooling

• Node: 22 (see .nvmrc)
• Package manager: pnpm@10.32.1
• Monorepo runner: Turborepo

Packages

• @wiseiodev/linear-core: auth, config, token storage, SDK gateway, output envelope
• @wiseiodev/skills-catalog: bundled skill registry + Vercel Skills CLI installer wrapper
• @wiseiodev/tui: Ink React terminal UI for issues, projects, initiatives, cycles
• @wiseiodev/linear-cli: linear and li command binaries

Install

pnpm install

Verify

pnpm verify

Run CLI

pnpm --filter @wiseiodev/linear-cli dev -- --help
pnpm --filter @wiseiodev/linear-cli dev -- issues list --json

Example Commands

# Auth
linear auth login
linear auth login --manual
linear auth status --json
linear auth api-key-set --api-key "$LINEAR_API_KEY"

# Docs bookmark
linear docs
linear docs --open

# Skills
linear skills list
linear skills install issue-triage

# CRUD
linear issues list --limit 10
linear issues branch ANN-123
linear issues browse
linear issues create --input '{"title":"Investigate bug","teamId":"<team-id>"}'
linear projects list
linear documents list

# TUI
linear tui --screen issues
linear tui --screen projects
linear tui --screen initiatives
linear tui --screen cycles

Skills In Repo

Downloadable skills are included at:

• assets/skills/issue-triage/SKILL.md
• assets/skills/cycle-planning/SKILL.md

Installer wrapper command:

linear skills install <skill-name>

This runs:

npx skills add <org/repo/path> https://github.com/vercel-labs/skills

Release Flows

Prerelease (automatic on main)

• Workflow: .github/workflows/release-prerelease.yml
• Publishes alpha prereleases to npm using semantic-release
• Dist-tag/channel: next

Production Release (manual)

• Workflow: .github/workflows/release-production.yml
• Triggered manually via GitHub Actions
• Publishes stable release to npm as latest

Linear SDK Docs

• SDK docs
• GraphQL docs
• OAuth docs
• SDK GraphQL schema