linearis

A command-line skill for managing Linear, a project-management service where teams track issues, projects, sprints, roadmaps, documents, and discussions.

In plain words
What is it for?
Use it to inspect or manage Linear issues, projects, cycles, milestones, initiatives, documents, labels, teams, users, and issue comments.
Why use it?
It lets developers work with Linear from a shell and receive machine-readable JSON instead of switching between manual web screens. It also explains how to handle missing installation and login requirements.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/linearis-oss/linearis/linearis
Any agent
npx skills add linearis-oss/linearis --skill linearis
Clone the repo
git clone --depth 1 https://github.com/linearis-oss/linearis

Made for: Claude Code, Codex.

Per session 111 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,125 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00111 $0.01125
Opus 5 $0.00056 $0.00562
Sonnet 5 $0.00022 $0.00225
Haiku 4.5 $0.00011 $0.00112

Measured yesterday against content hash 1189500b1390, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

linearis scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/linearis/SKILL.md · 52 lines

How it starts

The opening of the file, as written. The whole thing — 52 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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 login' …", "exit_code": 42 }. Detect it by exit_code === 42 / error === "AUTHENTICATION_REQUIRED" (not paraphrased text) and surface the CLI's own instruction. linearis auth login is an interactive browser flow you cannot complete — hand it to the user.
  • Invalid invocation — an unknown command or option, a wrong argument count, or a command group named without a subcommand fails on stderr with exit code 2: { "error": "UNKNOWN_COMMAND", "message": "…", "suggestion": "Did you mean read?", "command": "linearis issues", "available_commands": [...], "instruction": "Run 'linearis issues usage' …", "exit_code": 2 }. Recover from the envelope, not by guessing: pick from available_commands, or run the instruction. error is one of UNKNOWN_COMMAND, UNKNOWN_OPTION, MISSING_ARGUMENT, MISSING_REQUIRED_OPTION, MISSING_OPTION_ARGUMENT, TOO_MANY_ARGUMENTS, MISSING_SUBCOMMAND, INVALID_USAGE. A bare group (linearis issues) is a failure, not a request for help.
  • 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.

Read the full file on GitHub · 52 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 52 lines · 111 tokens per session scan A 1189500b1390

Subscribe to this mod's changes

linearis is a skill published in the GitHub repository linearis-oss/linearis (248 stars, last pushed 2d ago), licensed MIT. It adds 111 tokens to every session and 1,125 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

linctl

Use linctl as the Linear control surface for agent-safe issue, project, Cycle, ProjectMilestone, organization, user, team, search, release, initiative, customer, notification, attachment, comment, and metadata work. Prefer it over Linear MCP, raw GraphQL, or ad hoc API calls when linctl covers the operation; use…

KyaniteHQ/linctl · 80 tokens

linear

Linear project management — issues, cycles, and projects via GraphQL API.

furkangonel/cowrangler · 17 tokens

stale-sweep

Sweep the googleapis/mcp-toolbox repo for issues and PRs with no real activity in N days (default 60), sort each by whose silence it is (the author's, ours, or nobody's), and draft the nudge or close comment. Use whenever a maintainer asks for a stale sweep, backlog cleanup, or an SLO check, e.g. "stale sweep", "find…

googleapis/mcp-toolbox · 159 tokens

github-issue-triage

Issue triage and lifecycle management agent for ZeroClaw. Use this skill whenever the user wants to: triage open issues, close stale/duplicate/fixed issues, apply labels, run a backlog sweep, enforce the current issue stale policy, or handle a specific issue. Trigger on: 'triage issues', 'issue triage', 'sweep…

zeroclaw-labs/zeroclaw · 140 tokens

backlog-technical-project-manager

Technical project management for Backlog.md workstreams using coordinated sub-agents. Use only when the user explicitly asks Codex to take over one or more existing Backlog.md tasks (for example: "act as TPM", "coordinate these tasks", "delegate to sub-agents"). Orchestrate planning, implementation, and finalization…

MrLesk/Backlog.md · 90 tokens

goal-conductor

Own a long-horizon goal end to end - decompose it into work items, stand up one top-level session per item, patrol their state on a nudge loop, and decide each next round until the goal is met or a stop condition fires. Use when the user hands over a goal too large for one session ("clear the flaky-test backlog"…

kirodotdev/KiroCrew · 105 tokens