@@ -18,7 +18,7 @@ everything?" or "what's blocked anywhere?"
1818
1919### Scenarios That Must Work
2020
21- 1 . ** Single project** — ` cd ~/repos/app-a && work list ` — works today, must not regress
21+ 1 . ** Single project** — ` cd ~/repos/app-a && cmt list ` — works today, must not regress
22222 . ** Personal work** — ` cmt add "Read DDIA chapter 5" ` from ` ~ ` — needs ` ~/.cmt/ `
23233 . ** Cross-project overview** — "show all my active items everywhere"
24244 . ** Monorepo** — one ` .cmt/ ` at root covers all packages (no nesting)
@@ -89,9 +89,9 @@ other project.
8989
9090` ` ` bash
9191cd ~
92- work init --prefix ME
93- work add "Read DDIA chapter 5" --tag reading
94- work add "Update resume" --tag career -p high
92+ cmt init --prefix ME
93+ cmt add "Read DDIA chapter 5" --tag reading
94+ cmt add "Update resume" --tag career -p high
9595` ` `
9696
9797---
@@ -104,7 +104,7 @@ work add "Update resume" --tag career -p high
104104
105105` ` ` bash
106106cd ~/repos/new-service
107- work init --prefix SVC
107+ cmt init --prefix SVC
108108# Creates .cmt/ in current directory
109109# Appends to ~/.config/cmt/projects.yml automatically
110110` ` `
@@ -120,14 +120,14 @@ in project registry").
120120New flag : ` --all` (or `-a`). Queries every project in the registry.
121121
122122` ` ` bash
123- $ work list --all -s active
123+ $ cmt list --all -s active
124124PROJECT ID TITLE STATUS PRI ASSIGNEE
125125app-a API-0012 Fix auth middleware active ●H alice
126126app-b WEB-0045 Update dashboard active ●M alice
127127infra INFRA-003 Rotate certificates active ●H 🤖agent
128128personal ME-0007 Read DDIA chapter 5 active ●L —
129129
130- $ work list --all -s blocked --json
130+ $ cmt list --all -s blocked --json
131131[
132132 {"project": "app-a", "id": "API-0015", "title": "...", ...},
133133 {"project": "infra", "id": "INFRA-007", "title": "...", ...}
@@ -143,11 +143,11 @@ The `--dir` flag and `CMT_DIR` env already handle explicit project targeting:
143143
144144` ` ` bash
145145# From anywhere, operate on a specific project
146- work list --dir ~/repos/infra/.work -s blocked
146+ cmt list --dir ~/repos/infra/.work -s blocked
147147
148148# Or set for a session
149149export CMT_DIR=~/repos/infra/.work
150- work list -s blocked
150+ cmt list -s blocked
151151` ` `
152152
153153No new mechanism needed. The existing `--dir` flag is the escape hatch.
@@ -156,20 +156,20 @@ No new mechanism needed. The existing `--dir` flag is the escape hatch.
156156
157157` ` ` bash
158158# List registered projects
159- work projects
159+ cmt projects
160160 app-a API ~/repos/app-a/.work (24 items, 8 active)
161161 app-b WEB ~/repos/app-b/.work (12 items, 3 active)
162162 infra INFRA ~/repos/infra/.work (9 items, 2 active)
163163 personal ME ~/.work (15 items, 5 active)
164164
165165# Register an existing project (if auto-registration missed it)
166- work projects add ~/repos/legacy-app/.work
166+ cmt projects add ~/repos/legacy-app/.work
167167
168168# Remove a project from registry (does NOT delete .cmt/)
169- work projects remove legacy-app
169+ cmt projects remove legacy-app
170170
171171# Show current project
172- work projects current
172+ cmt projects current
173173 app-a (API) — ~/repos/app-a/.work
174174` ` `
175175
@@ -179,16 +179,16 @@ One `.cmt/` at the repo root. Use **tags** for package scoping:
179179
180180` ` ` bash
181181cd ~/repos/monorepo
182- work init --prefix MONO
182+ cmt init --prefix MONO
183183
184184# Scope with tags
185- work add "Fix auth bug" --tag package:auth
186- work add "Update dashboard" --tag package:web
187- work add "Shared types" --tag package:core
185+ cmt add "Fix auth bug" --tag package:auth
186+ cmt add "Update dashboard" --tag package:web
187+ cmt add "Shared types" --tag package:core
188188
189189# Filter by package
190- work list --tag package:auth
191- work list --tag package:web
190+ cmt list --tag package:auth
191+ cmt list --tag package:web
192192` ` `
193193
194194The tag namespace `package:` is conventional, not enforced. The web UI sidebar
@@ -257,7 +257,7 @@ The Dashboard view in `--all` mode shows per-project breakdowns:
257257
258258```
259259 ┌──────────────────────┐
260- │ work serve --all │
260+ │ cmt serve --all │
261261 │ (single process) │
262262 └───────┬──────────────┘
263263 │ reads
@@ -339,7 +339,7 @@ Just a list of paths and independent projects that can be queried together.
339339
340340**Q: What if I move a project directory?**
341341A: The registry path becomes stale. `cmt projects` detects this and shows
342- "(not found)". Fix with `cmt projects remove old-name && work projects add /new/path`.
342+ "(not found)". Fix with `cmt projects remove old-name && cmt projects add /new/path`.
343343Auto-cleanup: `cmt projects --prune` removes stale entries.
344344
345345**Q: What about teams? Does the registry sync via git?**
0 commit comments