Introduction
# linearis
CLI for [Linear.app](https://linear.app) with JSON output, designed for LLM agents.
## 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