linearis

Drive Linear.app from the shell via the linearis CLI (JSON-only output; linear is an alias). Do not guess the command surface — the CLI documents itself, and this skill teaches the protocol, not the flags.

Preflight (reactive — branch on the CLI's own output; don't pre-run checks every turn)

• Not installed — if the shell reports command-not-found, tell the user linearis isn't installed and offer npm install -g linearis. As a no-install fallback, prefix commands with npx linearis@latest (adds cold-start latency and needs network per call — fallback, not default). Never silently npm install -g.
• Auth required — any command may fail with this envelope on stderr and exit code 42: { "error": "AUTHENTICATION_REQUIRED", "action": "USER_ACTION_REQUIRED", "instruction": "Run 'linearis auth' …", "exit_code": 42 }. Detect it by exit_code === 42 / error === "AUTHENTICATION_REQUIRED" (not paraphrased text) and surface the CLI's own instruction. linearis auth is an interactive browser flow you cannot complete — hand it to the user.
• Updates (advisory, never blocking) — optionally run linearis version check once → { current, latest, channel, updateAvailable }. If updateAvailable is true, mention it and ask the user before npm install -g linearis@latest, honoring channel (don't move a next user to latest). npm can hang or rate-limit; on any timeout/error just proceed with the installed version. Read the plain installed version with linearis version (JSON), not --version.

Discover, then act

1. Run linearis usage once for the list of domains (issues, projects, cycles, …).
2. Run linearis <domain> usage for a domain's full command and flag reference before acting.
3. Never invent flags or subcommands — usage is authoritative and always current.

Output