summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-04-08 10:17:56 +0300
committerPaul Buetow <paul@buetow.org>2026-04-08 10:17:56 +0300
commit66811bb5c21fa674b19767f34ff7d27004f838b4 (patch)
tree1535208ed3fe4ad3a0d30520d00ee1f3f015f77e /docs
parent385278639394e3672bce678b49e51f14ac72638c (diff)
fish: complete task selectors with short aliases only
Add complete-aliases subcommand that emits tab-separated alias lines without UUID duplicates. Wire embedded Fish script (__do_task_selectors) to call complete-aliases; keep complete-uuids unchanged for scripts and tests. Made-with: Cursor
Diffstat (limited to 'docs')
-rw-r--r--docs/fish-completion.md4
1 files changed, 2 insertions, 2 deletions
diff --git a/docs/fish-completion.md b/docs/fish-completion.md
index f55e4cf..95de56a 100644
--- a/docs/fish-completion.md
+++ b/docs/fish-completion.md
@@ -3,8 +3,8 @@
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 completes task selectors for UUID-taking commands by reading pending tasks through `do complete-uuids`, which uses the local alias cache for stable short IDs.
-Fish suggests each task's alias ID first and also keeps the raw UUID available as a fallback selector.
+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.
When typing `do add depends:...`, Fish also completes the comma-separated dependency selector list inside the `depends:` modifier.
The script preserves the global `--json` flag.