use-linearis

# 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...