whoisnnamdi

Linearis

AI Agentv1.0.0
By whoisnnamdiUpdated 2026-05-11linearis@clawhub_whoisnnamdi/linearis
Tool Use#Json

According to AlphaMoat, as of 2026-09, Linearis has 3,553 downloads and 4 stars — ranked #3,085 of 5,078 AI skills overall, and #627 of 969 in AI Agent.

Installs
164
Downloads
3.6K
Stars
4
Overall Rank
#3,085
Top 61% overall · Top 65% in AI Agent
PlatformInstallsDownloadsStarsComments
ClawHub ↗1163.5K4-
SkillHub ↗1643.6K4—

Platforms count differently and update at different times.

What this skill does

Linearis provides JSON-oriented commands to list, search, read, create, and update Linear issues; create comments; manage documents; browse teams, users, projects, and cycles; and upload/download files. Use an installed, reviewed and pinned CLI with a least-privilege API token. Protect token storage and avoid plaintext token arguments that expose secrets in history or process listings. Confirm writes, deletion, and file transfers before execution.

Profile published 2026-10-27

What you can do with it

  • Search and read Linear issues or documents
  • Browse teams, users, projects, and cycles
  • After confirmation, edit issues, add comments, manage documents, or transfer files

When to use it

  • When querying or managing Linear work items through the CLI
  • After checking token scope and storage, and obtaining user confirmation before writes, deletion, or file transfer

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Search for a Linear issue in read-only mode and return JSON. Do not create, update, delete, upload, or download anything, and do not display the token in a command.

Monthly Trend

Downloads3.6K
2.5K3.1K3.6K2026-03 · Downloads 2.6K2026-05 · Downloads 3.0K2026-06 · Downloads 3.1K2026-07 · Downloads 3.3K2026-08 · Downloads 3.4K2026-09 · Downloads 3.6K26-0326-09
Stars4
3452026-03 · Stars 42026-05 · Stars 42026-06 · Stars 42026-07 · Stars 42026-08 · Stars 42026-09 · Stars 426-0326-09

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

MonthDownloadsMoMStars
2026-093.6K—4
2026-083.4K+3.7%4
2026-073.3K+6.9%4
2026-063.1K+4.0%4
2026-053.0K—4
2026-032.6K—4

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.4 KB · ClawHub v1.0.0
---
name: linearis
version: 1.0.0
description: 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.
metadata: {"clawdbot":{"emoji":"📋","requires":{"bins":["linearis"]},"install":[{"id":"npm","kind":"node","package":"linearis","bins":["linearis"],"label":"Install linearis (npm)"}]}}
---

# linearis

CLI for [Linear.app](https://linear.app) with JSON output, designed for LLM agents.
Show all (100 lines)

## Setup

```bash
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

```bash
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

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

### Documents

```bash
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

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

### Teams, Users, Projects

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

### Full Usage

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

## Output

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

```bash
linearis 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

Popular in AI Agent

Data month: 2026-09 · Downloads, stars and installs are aggregated monthly from public skill registries (ClawHub, SkillHub). See methodology.