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 --- README.md | 6 ++++-- docs/fish-completion.md | 1 + docs/usage.md | 15 +++++++++++++-- internal/version.go | 2 +- 4 files changed, 19 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index c4e47f3..e323c8b 100644 --- a/README.md +++ b/README.md @@ -17,8 +17,10 @@ It has got improved capabilities for Go code understanding (for example, create - Entrypoint: `do` (the binary was formerly named `ask`; use `do` in scripts and documentation) - Auto-scopes to `project: +agent` (derived from git repo root) - Override the project explicitly with `do proj: ` - - Never exposes numeric task IDs — uses UUIDs only - - Machine-friendly output: UUID-only tables, suppressed decorative text + - Prefixes can be combined, for example `do proj: na ` + - Never exposes numeric task IDs; human-facing output uses stable alias IDs + - `do info` hides raw UUIDs unless `HEXAI_DEBUG` is set + - Machine-friendly output with suppressed decorative text - Subcommands: `do add`, `do list`, `do info`, `do annotate`, `do start`, `do stop`, `do done`, `do priority`, `do tag`, `do dep`, `do urgency`, `do modify`, `do denotate`, `do delete`, `do fish`, `do help` - Fish completion generator: `do fish` * Parallel completions and CLI responses from multiple providers/models for side-by-side comparison 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 diff --git a/internal/version.go b/internal/version.go index 4f8f02d..817ccf8 100644 --- a/internal/version.go +++ b/internal/version.go @@ -1,4 +1,4 @@ // Package internal provides the Hexai semantic version identifier used by CLI and LSP binaries. package internal -const Version = "0.29.3" +const Version = "0.30.0" -- cgit v1.2.3