summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-04-10 22:54:14 +0300
committerPaul Buetow <paul@buetow.org>2026-04-10 22:54:14 +0300
commit2bc565ff006fa599b8feff027b0f96ff647a006a (patch)
treed0774769b5ef9c64bb7a76c55f201f9cee608deb
parentea9e7c0225f6af8179890516b5ce9d511dadb234 (diff)
release: v0.30.0
-rw-r--r--README.md6
-rw-r--r--docs/fish-completion.md1
-rw-r--r--docs/usage.md15
-rw-r--r--internal/version.go2
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:<repo> +agent` (derived from git repo root)
- Override the project explicitly with `do proj:<name> <subcommand...>`
- - 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:<name> na <subcommand...>`
+ - 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:<name> <subcommand...>` to override the project explicitly instead
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.
+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:<name>` 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"