linear-cli 0.3.1

A powerful CLI for Linear.app - manage issues, projects, cycles, and more from your terminal
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

# Agent Skills

`linear-cli` includes Agent Skills for AI coding assistants. Skills provide contextual documentation that agents can load when performing Linear tasks.

## Installation

```bash
# Install all skills
npx skills add Finesssee/linear-cli

# Install specific skill
npx skills add Finesssee/linear-cli --skill linear-list

# Install globally (available in all projects)
npx skills add Finesssee/linear-cli -g
```

## Available Skills (27 total)

### Issues
| Skill | Description |
|-------|-------------|
| `linear-list` | List and get issues |
| `linear-create` | Create issues |
| `linear-update` | Update issues (status, priority, assignee, labels) |
| `linear-workflow` | Start/stop work, get current issue context |

### Git
| Skill | Description |
|-------|-------------|
| `linear-git` | Branches, checkout, context |
| `linear-pr` | Create GitHub PRs |

### Planning
| Skill | Description |
|-------|-------------|
| `linear-projects` | Manage projects |
| `linear-roadmaps` | View roadmaps |
| `linear-initiatives` | High-level tracking |
| `linear-cycles` | Sprint cycles |

### Organization
| Skill | Description |
|-------|-------------|
| `linear-teams` | Teams and users |
| `linear-labels` | Label management |
| `linear-relations` | Issue relationships (blocks, parent/child) |
| `linear-templates` | Issue templates |

### Operations
| Skill | Description |
|-------|-------------|
| `linear-bulk` | Bulk operations |
| `linear-export` | Export to CSV/Markdown |
| `linear-triage` | Triage inbox |
| `linear-favorites` | Quick access |

### Tracking
| Skill | Description |
|-------|-------------|
| `linear-metrics` | Velocity, burndown, progress |
| `linear-history` | Issue activity logs |
| `linear-time` | Time tracking |
| `linear-watch` | Watch for updates |

### Other
| Skill | Description |
|-------|-------------|
| `linear-search` | Search issues and projects |
| `linear-notifications` | Manage notifications |
| `linear-documents` | Documentation |
| `linear-uploads` | Download attachments |
| `linear-config` | Auth, API keys, workspaces, diagnostics |

## Supported Agents

Skills work with any agent that supports the [Agent Skills](https://agentskills.io) format:

- Claude Code
- OpenAI Codex
- Cursor
- Amp
- Roo Code
- Gemini CLI
- And many more

## Why Skills?

Skills are 10-50x more token-efficient than MCP tools:

- **MCP tools**: Each API call returns full JSON, uses many tokens
- **Skills**: Agent learns commands once, uses CLI directly

## Viewing Installed Skills

```bash
# List installed skills
npx skills list

# List globally installed
npx skills list -g
```

## Skill Contents

Each skill contains:

- **Frontmatter**: Name, description, allowed tools
- **Commands**: CLI commands with examples
- **Flags**: Agent-optimized flags (`--output json`, `--compact`, etc.)
- **Exit codes**: For error handling
- **Workflows**: Common task patterns

Example skill structure:
```yaml
---
name: linear-list
description: List and get Linear issues...
allowed-tools: Bash
---

# List/Get Issues

\`\`\`bash
linear-cli i list --output json
\`\`\`
```

## Updating Skills

```bash
# Check for updates
npx skills check

# Update all skills
npx skills update
```

## Removing Skills

```bash
# Remove specific skill
npx skills remove --skill linear-list

# Remove all linear-cli skills
npx skills remove Finesssee/linear-cli
```