From 0088bf27368265511d6ff3c49309df843c528d42 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Tue, 26 May 2026 10:15:58 +0300
Subject: 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.
---
 docs/usage.md | 1 +
 1 file changed, 1 insertion(+)

(limited to 'docs')

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 |
-- 
cgit v1.2.3