linearis
CLI tool for Linear.app with JSON output, smart ID resolution, and optimized GraphQL queries. Designed for LLM agents and humans who prefer structured data.
What is linearis?
CLI tool for Linear.app with JSON output, smart ID resolution, and optimized GraphQL queries. Designed for LLM agents and humans who prefer structured data.
Overview of linearis
What it is
Linearis is a token-efficient command-line interface for Linear.app that outputs JSON only. It resolves human-friendly identifiers (such as ENG-42 or a team name) to UUIDs automatically, and exposes a two-tier usage system so that an agent can discover exactly the commands it needs without loading the whole API surface into context. It is designed for LLM agents and humans who prefer structured data.
Key features
- JSON-only output — pipe into
jq, no parsing of tables or prose. - Smart ID resolution — pass
ENG-42, a team name, or a UUID interchangeably. - Two-tier discovery — self-documenting
usagecommands keep agent context small. - Discussion threads — first-class root/reply modeling on issues.
- File attachments — upload and download with signed URLs.
- Broad domain coverage — issues, projects, cycles, milestones, initiatives, documents, labels, teams, users, and more.
Use cases
- AI agents that need to interact with Linear using minimal token context.
- Humans who prefer structured JSON output for scripting or piping into tools like
jq. - Batch creating or updating issues from a JSON document in a single transaction.
- Managing discussion threads on issues, projects, and initiatives.
- Handling file attachments with signed URLs.
Getting started
bashnpm install -g linearislinearis auth loginlinearis issues list --limit 10
License and pricing
MIT open source license.
Based on the project's public README and repository metadata.