From ea9e7c0225f6af8179890516b5ce9d511dadb234 Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Fri, 10 Apr 2026 22:47:34 +0300 Subject: task 30: add proj prefix override for do --- docs/usage.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) (limited to 'docs/usage.md') diff --git a/docs/usage.md b/docs/usage.md index ee811a3..7dd0a2e 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -129,11 +129,13 @@ cat SOMEFILE.txt | hexai --tps-simulation 20 By default it auto-scopes to `project: +agent` so operations are confined to agent-managed project tasks. +Use `do proj: ` to override the project explicitly instead of deriving it from the current git repository. + Use `do na ` or `do no-agent ` to run the same subcommands against project tasks without the `+agent` tag. Those prefixes keep the project scope but replace the default tag filter with `-agent`. `do` never exposes Taskwarrior numeric task IDs. Human-facing output uses stable local alias IDs where practical, while `do info` shows both the alias ID and the UUID. Commands that accept a task selector support either the alias ID or the UUID. -`do` must be run inside a git repository so the project name can be derived from the repo root. +`do` must be run inside a git repository unless you provide an explicit `proj:` override. ### Subcommands -- cgit v1.2.3