@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.
@@ -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 (if in a repo):**
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 on beautiful-tech
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
- - If not in a git repo, GitHub section will be skipped
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 --backlog # Backlog issues only
51
- linear issues --in-progress # Issues currently in progress
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
- # Flags can be combined: linear issues --in-progress --mine
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 update ISSUE-1 --state "In Progress"
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 --blocks ISSUE-2 # Add blocking relation
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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dabble/linear-cli",
3
- "version": "1.0.5",
3
+ "version": "1.1.1",
4
4
  "description": "Linear CLI with unblocked issue filtering, built for AI-assisted development",
5
5
  "type": "module",
6
6
  "bin": {