davidgasquez.com
🔧 Where my dotfiles lives in harmony and peace, most of the time
📝 Update Todoist skill docs for URL-based views
+24
-6
agents/skills/todoist-cli/SKILL.md
+24
-6
agents/skills/todoist-cli/SKILL.md
···
18
18
- `td task complete <ref>` - Complete a task
19
19
- `td project list` - List projects
20
20
- `td label list` - List labels
21
-
- `td filter list/show` - Manage and use saved filters
21
+
- `td filter list/view` - Manage and use saved filters
22
22
- `td workspace list` - List workspaces
23
23
- `td activity` - Activity logs
24
24
- `td notification list` - Notifications
···
26
26
- `td stats` - Productivity stats
27
27
- `td settings view` - User settings
28
28
- `td completion install` - Install shell completions
29
+
- `td view <url>` - View any Todoist entity by URL
29
30
30
31
## Output Formats
31
32
···
49
50
- `--progress-jsonl` - Machine-readable progress events (JSONL to stderr)
50
51
- `-v, --verbose` - Verbose output to stderr (repeat: -v info, -vv detail, -vvv debug, -vvvv trace)
51
52
52
-
## Task References
53
+
## References
53
54
54
-
Tasks can be referenced by:
55
+
Tasks, projects, labels, and filters can be referenced by:
55
56
- Name (fuzzy matched within context)
56
-
- `id:xxx` - Explicit task ID
57
+
- `id:xxx` - Explicit ID
58
+
- Todoist URL - Paste directly from the web app (e.g., `https://app.todoist.com/app/task/buy-milk-8Jx4mVr72kPn3QwB` or `https://app.todoist.com/app/project/work-2pN7vKx49mRq6YhT`)
57
59
58
60
## Priority Mapping
59
61
···
160
162
161
163
### Labels
162
164
```bash
163
-
td label list
165
+
td label list # Lists personal + shared labels
166
+
td label view "urgent" # View label details and tasks
167
+
td label view "team-review" # Works for shared labels too
164
168
td label create --name "urgent" --color "red"
165
169
td label update "urgent" --color "orange"
166
170
td label delete "urgent" --yes
167
171
td label browse "urgent" # Open in browser
168
172
```
169
173
174
+
Note: Shared labels (from collaborative projects) appear in `list` and can be viewed, but cannot be deleted/updated via the standard label commands since they have no ID.
175
+
170
176
### Comments
171
177
```bash
172
178
td comment list --task "task name"
···
193
199
```bash
194
200
td filter list
195
201
td filter create --name "Urgent work" --query "p1 & #Work"
196
-
td filter show "Urgent work" # Show tasks matching filter
202
+
td filter view "Urgent work" # Show tasks matching filter (alias: show)
197
203
td filter update "Urgent work" --query "p1 & #Work & today"
198
204
td filter delete "Urgent work" --yes
199
205
td filter browse "Urgent work" # Open in browser
···
261
267
td completion install zsh
262
268
td completion install fish
263
269
td completion uninstall # Remove completions
270
+
```
271
+
272
+
### View (URL Router)
273
+
```bash
274
+
td view <todoist-url> # Auto-route to appropriate view by URL type
275
+
td view https://app.todoist.com/app/task/buy-milk-abc123
276
+
td view https://app.todoist.com/app/project/work-def456
277
+
td view https://app.todoist.com/app/label/urgent-ghi789
278
+
td view https://app.todoist.com/app/filter/work-tasks-jkl012
279
+
td view https://app.todoist.com/app/today
280
+
td view https://app.todoist.com/app/upcoming
281
+
td view <url> --json # JSON output for entity views
264
282
```
265
283
266
284
## Examples