linear-cli 0.2.6

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

# Agent Skills

`linear-cli` includes pre-built skills for AI coding assistants. Skills provide contextual documentation that agents can load when performing specific tasks.

## Supported Agents

| Agent | Skills Location | Skill File |
|-------|-----------------|------------|
| Claude Code | `.claude/skills/` | `SKILL.md` |
| OpenAI Codex | `.codex/skills/` | `AGENTS.md` |

## Available Skills

| Skill | Description |
|-------|-------------|
| `linear-issues` | Manage issues - list, create, update, start/stop work |
| `linear-pr` | Create GitHub PRs linked to Linear issues |
| `linear-search` | Search issues and projects |
| `linear-uploads` | Download attachments and images |

## Installation

### Option 1: Clone to Your Project

Copy the skills directories to your project:

```bash
# For Claude Code
cp -r /path/to/linear-cli/.claude/skills/* /your/project/.claude/skills/

# For OpenAI Codex
cp -r /path/to/linear-cli/.codex/skills/* /your/project/.codex/skills/
```

### Option 2: Symlink (Recommended)

Symlink the skills from your linear-cli installation:

```bash
# Find where linear-cli is installed
which linear-cli  # or: where linear-cli on Windows

# Assuming it's installed via cargo
SKILLS_SRC="$HOME/.cargo/git/checkouts/linear-cli-*/master"

# For Claude Code
ln -s "$SKILLS_SRC/.claude/skills" /your/project/.claude/skills

# For OpenAI Codex
ln -s "$SKILLS_SRC/.codex/skills" /your/project/.codex/skills
```

### Option 3: Global Installation

For Claude Code, you can install skills globally:

```bash
# Copy to global Claude config
mkdir -p ~/.claude/skills
cp -r /path/to/linear-cli/.claude/skills/* ~/.claude/skills/
```

## How Skills Work

### Claude Code

Claude Code loads skills based on the `description` field in `SKILL.md`. When you ask about Linear issues, PRs, or uploads, Claude automatically loads the relevant skill.

Example `SKILL.md` structure:
```yaml
---
name: linear-issues
description: Manage Linear issues - list, create, update, start/stop work.
allowed-tools: Bash
---

# Linear Issues
[Documentation content...]
```

### OpenAI Codex

Codex reads `AGENTS.md` files for contextual instructions. Place skills in `.codex/skills/` directories.

## Verifying Installation

### Claude Code

Ask Claude: "What Linear commands are available?"

Claude should reference the skills and show commands like:
- `linear-cli i list`
- `linear-cli i create "Title" -t TEAM`
- etc.

### OpenAI Codex

Ask Codex to work with Linear issues. It should use `linear-cli` commands rather than suggesting MCP tools.

## Creating Custom Skills

You can extend the skills or create new ones:

```bash
# Create a new skill for your workflow
mkdir -p .claude/skills/my-workflow
cat > .claude/skills/my-workflow/SKILL.md << 'EOF'
---
name: my-workflow
description: Custom Linear workflow for my team
allowed-tools: Bash
---

# My Custom Workflow

## Daily Standup
\`\`\`bash
linear-cli i list -s "In Progress" --mine
\`\`\`
EOF
```