From 2bc565ff006fa599b8feff027b0f96ff647a006a Mon Sep 17 00:00:00 2001 From: Paul Buetow Date: Fri, 10 Apr 2026 22:54:14 +0300 Subject: release: v0.30.0 --- docs/fish-completion.md | 1 + docs/usage.md | 15 +++++++++++++-- 2 files changed, 14 insertions(+), 2 deletions(-) (limited to 'docs') diff --git a/docs/fish-completion.md b/docs/fish-completion.md index c582800..19a90be 100644 --- a/docs/fish-completion.md +++ b/docs/fish-completion.md @@ -3,6 +3,7 @@ The `do` task-management CLI embeds its Fish completion script in the binary and prints it with `do fish`. It completes the top-level `do` subcommands and the nested `do dep` operations. +It also suggests the global task prefixes `na`, `no-agent`, and `proj:`. It also completes task selectors for UUID-taking commands by reading pending tasks through `do complete-aliases`, which uses the local alias cache for stable short IDs. The `do complete-uuids` command still emits both alias and UUID lines for scripts and tests that need the full selector list. Selector suggestions stop once a command has consumed its selector argument, and `do dep add` / `do dep rm` suggest selectors for both task positions. diff --git a/docs/usage.md b/docs/usage.md index 7dd0a2e..3ebd76e 100644 --- a/docs/usage.md +++ b/docs/usage.md @@ -133,7 +133,9 @@ Use `do proj: ` to override the project explicitly instead 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. +You can combine the prefixes in either order, for example `do proj:hexai na list` or `do na proj:hexai list`. + +`do` never exposes Taskwarrior numeric task IDs. Human-facing output uses stable local alias IDs where practical. `do info` hides the raw UUID by default and only prints it when `HEXAI_DEBUG` is set. Commands that accept a task selector still support either the alias ID or the UUID. `do` must be run inside a git repository unless you provide an explicit `proj:` override. @@ -180,6 +182,12 @@ do add priority:H "Implement new feature" # Create a non-agent task do na add "Follow up manually" +# List tasks for a project from outside its git repository +do proj:hexai list + +# Combine project override and non-agent scope +do proj:hexai na list + # Create a task with dependencies do add +cli depends:0,1 "Implement dependent feature" @@ -189,9 +197,12 @@ do list +READY limit:5 # List non-agent tasks do no-agent list -# Show alias and UUID for a task +# Show task details do info 0 +# Show the raw UUID as well +HEXAI_DEBUG=1 do info 0 + # Show a non-agent task do na info 0 -- cgit v1.2.3