summaryrefslogtreecommitdiff
path: root/docs/usage.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-04-10 22:47:34 +0300
committerPaul Buetow <paul@buetow.org>2026-04-10 22:47:34 +0300
commitea9e7c0225f6af8179890516b5ce9d511dadb234 (patch)
treee5d64837c8823d315af40162cf5f10491a06b755 /docs/usage.md
parentbd749f8e9a0eeaa5578a368996f7b93955580a39 (diff)
task 30: add proj prefix override for do
Diffstat (limited to 'docs/usage.md')
-rw-r--r--docs/usage.md4
1 files changed, 3 insertions, 1 deletions
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:<repo> +agent` so operations are confined to agent-managed project tasks.
+Use `do proj:<name> <subcommand...>` to override the project explicitly instead of deriving it from the current git repository.
+
Use `do na <subcommand...>` or `do no-agent <subcommand...>` 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:<name>` override.
### Subcommands