summaryrefslogtreecommitdiff
path: root/docs/usage.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-05-26 10:15:58 +0300
committerPaul Buetow <paul@buetow.org>2026-05-26 10:15:58 +0300
commit0088bf27368265511d6ff3c49309df843c528d42 (patch)
tree321becbc133e59dc2be31ec27fd1a6a69e8d7ca7 /docs/usage.md
parentc4ffb4b994faa3df1760cd1144a8dafcefeb991b (diff)
feat(askcli): add watch subcommand
Implements `ask watch [subcommand...]` which re-runs a read-only subcommand every 2 seconds and redraws output when it changes, similar to gnu-watch. Safety features: - Restricted to read-only subcommands (list, all, ready, info, urgency, help, dep list) - Recursive watch is blocked - Captures stderr so error messages are visible in the watched display Also adds readOnly field to commandEntry registry for maintainability.
Diffstat (limited to 'docs/usage.md')
-rw-r--r--docs/usage.md1
1 files changed, 1 insertions, 0 deletions
diff --git a/docs/usage.md b/docs/usage.md
index 40e8e82..06ec2f1 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -170,6 +170,7 @@ You can combine the prefixes in either order, for example `ask proj:hexai na lis
| `ask dep rm <id\|uuid> <dep-id\|dep-uuid>` | Remove dependency |
| `ask dep list <id\|uuid>` | List dependencies |
| `ask urgency` | List tasks by urgency |
+| `ask watch [subcommand...]` | Re-run a read-only subcommand every 2s and redraw when output changes; defaults to `ask list` |
| `ask modify <id\|uuid> <args...>` | General-purpose modify |
| `ask denotate <id\|uuid> "text"` | Remove annotation |
| `ask delete <id\|uuid>` | Delete a task |