use-linearislisted

Use when running Linear.app operations from the command line — creating, updating, archiving, listing, or filtering issues, setting project milestones, or wiring blocked-by relations via the `linearis` CLI (binaries `linear` and `linearis`, JSON output) instead of an MCP or the web UI. Triggers on any Linear issue/project/milestone task in a terminal, and on syncing Kevin's Ogham roadmap with its shared-memory database. Covers generic install/auth setup, the CLI's sharp edges, and the local env.sh split that keeps workspace identifiers out of the repo. Not a full reference — that's `linear <cmd> --help`.
kevin-burns/claude-skills · ★ 8 · Data & Documents · score 81

Install: claude install-skill kevin-burns/claude-skills

# use-linearis `linearis` is a Node CLI for Linear.app — JSON output, smart ID resolution, cursor pagination, built for LLM agents. It ships two identical binaries, `linear` and `linearis`. It is **not** an MCP: no tool schemas land in context, so every fresh session pays a discovery tax. This skill pays that tax up front — generic setup, the CLI's sharp edges, and the Ogham dogfooding workflow. It carries **no real workspace identifiers** — those live in a local `~/.config/dotfiles/env.sh` you source (see below). If Linear ships an official MCP with write support, migrate to it. Until then, `linearis` is the agent-shaped CLI. ## Setup (generic — works for any Linear workspace) **Source:** <https://github.com/linearis-oss/linearis> · npm package `linearis` (MIT). Requires Node. Install globally, then authenticate: ```bash npm i -g linearis # installs BOTH `linear` and `linearis` (same binary) linear auth login # browser OAuth; stores a token at ~/.linearis/token ``` One-liner to confirm it's installed and authed: ```bash command -v linear >/dev/null && linear auth status || echo "install: npm i -g linearis && linear auth login" ``` `auth status` returns `{authenticated: true, user: {name, email}}` when a token is live at `~/.linearis/token`. If write operations fail with `Invalid scope: write required`, generate a Personal API Key in the Linear web UI (Settings → API → Personal API keys) with `admin` scope, then either `export LINEAR_API_TOKEN=<key>` or