Add ask Taskwarrior wrapper

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/usage.md b/docs/usage.md
index 8404969..571956b 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -123,6 +123,22 @@ hexai --tps-simulation 12-18
 cat SOMEFILE.txt | hexai --tps-simulation 20
 ```
 
+## Taskwarrior proxy
+
+Use `ask` when you want Taskwarrior automatically scoped to the current git repo and the `+agent` tag.
+
+- `ask list`
+- `ask add priority:H "Implement X"`
+- `ask uuid:1234 annotate "Delivered Y"`
+- `ask 42 done`
+
+`ask` pre-sets `project:<repo> +agent` and then forwards the remaining arguments to Taskwarrior unchanged, so normal reports, filters, UUID selectors, and commands still work. It must be run inside a git repository so the project name can be derived from the repo root.
+
+Compatibility note: `hexai task ...` still works and behaves the same way, but `ask ...` is the shorter preferred entrypoint for agent-managed project tasks.
+
+- `hexai task list`
+- `hexai task uuid:1234 annotate "Delivered Y"`
+
 ## Hexai Action (TUI)
 
 `hexai-tmux-action` runs code actions over a selection or diagnostics+selection piped from stdin, or read from a file.