How do I install the Linearis skill?

Run npx skillmds@latest add dvcrn/linearis in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Linearis safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Linearis?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Linearis free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Linearis?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Linearis by dvcrn — Agent Skill

Name: Linearis
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

linearis

CLI for Linear.app with JSON output, designed for LLM agents.

Setup

npm install -g linearis

Auth (one of):

echo "lin_api_..." > ~/.linear_api_token (recommended)
export LINEAR_API_TOKEN="lin_api_..."
--api-token <token> flag

Get API key: Linear Settings → Security & Access → Personal API keys

Commands

Issues

linearis issues list -l 20              # List recent issues
linearis issues list -l 10 --team WHO   # Filter by team
linearis issues search "bug"            # Full-text search
linearis issues read ABC-123            # Get issue details
linearis issues create --title "Fix bug" --team WHO --priority 2
linearis issues update ABC-123 --status "Done"
linearis issues update ABC-123 --title "New title" --assignee user123
linearis issues update ABC-123 --labels "Bug,Critical" --label-by adding
linearis issues update ABC-123 --parent-ticket EPIC-100  # Set parent

Comments

linearis comments create ABC-123 --body "Fixed in PR #456"

Documents

linearis documents list
linearis documents list --project "Backend"
linearis documents create --title "Spec" --content "# Overview..."
linearis documents read <doc-id>
linearis documents update <doc-id> --content "Updated"
linearis documents delete <doc-id>

File Uploads/Downloads

linearis embeds upload ./screenshot.png
linearis embeds download "<url>" --output ./file.png

Teams, Users, Projects

linearis teams list
linearis users list --active
linearis projects list
linearis cycles list --team WHO --active

Full Usage

linearis usage  # Complete command reference (~1k tokens)

Output

All commands return JSON by default. Pipe to jq for processing:

linearis issues list -l 5 | jq '.[].identifier'

Priority Values

0: No priority
1: Urgent
2: High
3: Medium
4: Low

Links

---name: linearisdescription: Linear.app CLI for issue tracking. Use for listing, creating, updating, and searching Linear issues, comments, documents, cycles, and projects. Optimized for LLM agents with JSON output.---# linearisCLI for [Linear.app](https://linear.app) with JSON output, designed for LLM agents.## Setup```bashnpm install -g linearis```Auth (one of):- `echo "lin_api_..." > ~/.linear_api_token` (recommended)- `export LINEAR_API_TOKEN="lin_api_..."`- `--api-token <token>` flagGet API key: Linear Settings → Security & Access → Personal API keys## Commands### Issues```bashlinearis issues list -l 20 # List recent issueslinearis issues list -l 10 --team WHO # Filter by teamlinearis issues search "bug" # Full-text searchlinearis issues read ABC-123 # Get issue detailslinearis issues create --title "Fix bug" --team WHO --priority 2linearis issues update ABC-123 --status "Done"linearis issues update ABC-123 --title "New title" --assignee user123linearis issues update ABC-123 --labels "Bug,Critical" --label-by addinglinearis issues update ABC-123 --parent-ticket EPIC-100 # Set parent```### Comments```bashlinearis comments create ABC-123 --body "Fixed in PR #456"```### Documents```bashlinearis documents listlinearis documents list --project "Backend"linearis documents create --title "Spec" --content "# Overview..."linearis documents read <doc-id>linearis documents update <doc-id> --content "Updated"linearis documents delete <doc-id>```### File Uploads/Downloads```bashlinearis embeds upload ./screenshot.pnglinearis embeds download "<url>" --output ./file.png```### Teams, Users, Projects```bashlinearis teams listlinearis users list --activelinearis projects listlinearis cycles list --team WHO --active```### Full Usage```bashlinearis usage # Complete command reference (~1k tokens)```## OutputAll commands return JSON by default. Pipe to `jq` for processing:```bashlinearis issues list -l 5 | jq '.[].identifier'```## Priority Values- 0: No priority- 1: Urgent- 2: High- 3: Medium- 4: Low## Links- Docs: https://github.com/czottmann/linearis- Blog: https://zottmann.org/2025/09/03/linearis-my-linear-cli-built.html

Frequently asked questions

Linearis