@dabble/linear-cli 1.0.5 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -1
- package/bin/linear.mjs +659 -183
- package/claude/commands/standup.md +6 -5
- package/claude/skills/linear-cli/SKILL.md +83 -6
- package/package.json +1 -1
|
@@ -17,8 +17,8 @@ Run `linear standup` to get:
|
|
|
17
17
|
- Issues currently in progress
|
|
18
18
|
- Issues that are blocked
|
|
19
19
|
|
|
20
|
-
**From GitHub (
|
|
21
|
-
- Commits you made yesterday
|
|
20
|
+
**From GitHub (across all repos):**
|
|
21
|
+
- Commits you made yesterday, grouped by repo
|
|
22
22
|
- PRs you opened or merged yesterday
|
|
23
23
|
|
|
24
24
|
## After Running
|
|
@@ -48,8 +48,9 @@ Here's your standup summary:
|
|
|
48
48
|
**Blocked:**
|
|
49
49
|
⊘ ISSUE-12: Waiting on API credentials
|
|
50
50
|
|
|
51
|
-
**GitHub:**
|
|
52
|
-
- 4 commits
|
|
51
|
+
**GitHub (all repos):**
|
|
52
|
+
- dabble/beautiful-tech: 4 commits
|
|
53
|
+
- dabble/linear-cli: 2 commits
|
|
53
54
|
- PR #42 merged: ISSUE-5: Add caching layer
|
|
54
55
|
|
|
55
56
|
[Presents options above]
|
|
@@ -59,5 +60,5 @@ Here's your standup summary:
|
|
|
59
60
|
|
|
60
61
|
- The `linear standup` command handles all the data fetching
|
|
61
62
|
- GitHub info requires the `gh` CLI to be installed and authenticated
|
|
62
|
-
-
|
|
63
|
+
- Shows activity across all GitHub repos, not just the current one
|
|
63
64
|
- Use `--no-github` flag to skip GitHub even if available
|
|
@@ -31,6 +31,45 @@ Config is loaded in order: `./.linear` → `~/.linear` → env vars
|
|
|
31
31
|
# .linear file format
|
|
32
32
|
api_key=lin_api_xxx
|
|
33
33
|
team=ISSUE
|
|
34
|
+
|
|
35
|
+
[aliases]
|
|
36
|
+
V2=Version 2.0 Release
|
|
37
|
+
MVP=MVP Milestone
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Aliases
|
|
41
|
+
|
|
42
|
+
Create short codes for projects and milestones to use in commands:
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
# Create aliases
|
|
46
|
+
linear alias V2 "Version 2.0" # For a project
|
|
47
|
+
linear alias MVP "MVP Milestone" # For a milestone
|
|
48
|
+
|
|
49
|
+
# List all aliases
|
|
50
|
+
linear alias --list
|
|
51
|
+
|
|
52
|
+
# Remove an alias
|
|
53
|
+
linear alias --remove MVP
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Use aliases anywhere a project or milestone name is accepted:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
linear issues --project V2
|
|
60
|
+
linear issues --milestone MVP
|
|
61
|
+
linear issue create --project V2 --milestone MVP "New feature"
|
|
62
|
+
linear milestones --project V2
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
Aliases are shown in `linear projects` and `linear milestones` output:
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
Projects:
|
|
69
|
+
[V2] Version 2.0 Release started 58%
|
|
70
|
+
|
|
71
|
+
Milestones:
|
|
72
|
+
[MVP] MVP Milestone [next]
|
|
34
73
|
```
|
|
35
74
|
|
|
36
75
|
## Quick Reference
|
|
@@ -45,24 +84,36 @@ linear whoami # Show current user/team
|
|
|
45
84
|
linear roadmap # Projects with milestones and progress
|
|
46
85
|
|
|
47
86
|
# Issues
|
|
87
|
+
linear issues # Default: backlog + todo issues
|
|
48
88
|
linear issues --unblocked # Ready to work on (no blockers)
|
|
49
89
|
linear issues --open # All non-completed issues
|
|
50
|
-
linear issues --
|
|
51
|
-
linear issues --
|
|
90
|
+
linear issues --status todo # Only todo issues
|
|
91
|
+
linear issues --status backlog # Only backlog issues
|
|
92
|
+
linear issues --status in-progress # Issues currently in progress
|
|
93
|
+
linear issues --status todo --status in-progress # Multiple statuses
|
|
52
94
|
linear issues --mine # Only your assigned issues
|
|
53
95
|
linear issues --project "Name" # Issues in a project
|
|
54
96
|
linear issues --milestone "M1" # Issues in a milestone
|
|
55
97
|
linear issues --label bug # Filter by label
|
|
56
|
-
|
|
98
|
+
linear issues --priority urgent # Filter by priority (urgent/high/medium/low/none)
|
|
99
|
+
# Flags can be combined: linear issues --status todo --mine
|
|
57
100
|
linear issue show ISSUE-1 # Full details with parent context
|
|
58
101
|
linear issue start ISSUE-1 # Assign to you + set In Progress
|
|
59
102
|
linear issue create --title "Fix bug" --project "Phase 1" --assign --estimate M
|
|
103
|
+
linear issue create --title "Urgent bug" --priority urgent --assign
|
|
60
104
|
linear issue create --title "Task" --milestone "Beta" --estimate S
|
|
61
|
-
linear issue create --title "Blocked task" --blocked-by ISSUE-1
|
|
62
|
-
linear issue
|
|
105
|
+
linear issue create --title "Blocked task" --blocked-by ISSUE-1 --blocked-by ISSUE-2
|
|
106
|
+
linear issue create --title "Labeled" --label bug --label frontend # Multiple labels
|
|
107
|
+
linear issue update ISSUE-1 --status "In Progress"
|
|
108
|
+
linear issue update ISSUE-1 --priority high # Set priority
|
|
109
|
+
linear issue update ISSUE-1 --estimate M # Set estimate
|
|
110
|
+
linear issue update ISSUE-1 --label bug --label frontend # Set labels (repeatable)
|
|
111
|
+
linear issue update ISSUE-1 --assign # Assign to yourself
|
|
112
|
+
linear issue update ISSUE-1 --parent ISSUE-2 # Set parent issue
|
|
63
113
|
linear issue update ISSUE-1 --milestone "Beta"
|
|
64
114
|
linear issue update ISSUE-1 --append "Notes..."
|
|
65
|
-
linear issue update ISSUE-1 --
|
|
115
|
+
linear issue update ISSUE-1 --check "validation" # Check off a todo item
|
|
116
|
+
linear issue update ISSUE-1 --blocks ISSUE-2 --blocks ISSUE-3 # Repeatable
|
|
66
117
|
linear issue close ISSUE-1
|
|
67
118
|
linear issue comment ISSUE-1 "Comment text"
|
|
68
119
|
|
|
@@ -90,6 +141,12 @@ linear issue move ISSUE-5 --before ISSUE-1 # Move single issue
|
|
|
90
141
|
linear labels # List all labels
|
|
91
142
|
linear label create "bug" --color "#FF0000"
|
|
92
143
|
|
|
144
|
+
# Aliases
|
|
145
|
+
linear alias V2 "Version 2.0" # Create alias for project/milestone
|
|
146
|
+
linear alias --list # List all aliases
|
|
147
|
+
linear alias --remove V2 # Remove alias
|
|
148
|
+
# Then use: linear issues --project V2
|
|
149
|
+
|
|
93
150
|
# Git
|
|
94
151
|
linear branch ISSUE-1 # Create branch: ISSUE-1-issue-title
|
|
95
152
|
```
|
|
@@ -174,6 +231,26 @@ linear issue create --title "Step 3: Add tests" --parent ISSUE-5 --estimate S
|
|
|
174
231
|
linear issue start ISSUE-6
|
|
175
232
|
```
|
|
176
233
|
|
|
234
|
+
### Checklists vs. sub-issues
|
|
235
|
+
Use description checklists for lightweight steps within a single issue. Use sub-issues when items need their own status, assignee, or estimate.
|
|
236
|
+
|
|
237
|
+
```bash
|
|
238
|
+
# Checklist — quick implementation steps, a punch list, acceptance criteria
|
|
239
|
+
linear issue update ISSUE-5 --append "## TODO\n- [ ] Add validation\n- [ ] Update tests\n- [ ] Check edge cases"
|
|
240
|
+
|
|
241
|
+
# Check off completed items (fuzzy matches the item text)
|
|
242
|
+
linear issue update ISSUE-5 --check "validation"
|
|
243
|
+
linear issue update ISSUE-5 --check "tests"
|
|
244
|
+
|
|
245
|
+
# Uncheck if needed
|
|
246
|
+
linear issue update ISSUE-5 --uncheck "validation"
|
|
247
|
+
|
|
248
|
+
# Sub-issues — substantial, independently trackable work
|
|
249
|
+
linear issue create --title "Add login endpoint" --parent ISSUE-5 --estimate S
|
|
250
|
+
```
|
|
251
|
+
|
|
252
|
+
Prefer checklists when the items are small and don't need independent tracking. Prefer sub-issues when you'd want to assign, estimate, or block on them individually. Use `--check` to mark items complete as you finish them.
|
|
253
|
+
|
|
177
254
|
### Completing work
|
|
178
255
|
After finishing implementation, ask the developer if they want to close the issue:
|
|
179
256
|
|