summaryrefslogtreecommitdiff
path: root/docs/fish-completion.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-04-08 09:58:02 +0300
committerPaul Buetow <paul@buetow.org>2026-04-08 09:58:02 +0300
commit8e351c86502cea78f1f0b3aa19cde7ca702bacab (patch)
tree1340e27219255b0ebe49bdbe3b5c2fbd95df8810 /docs/fish-completion.md
parent9e8f558a1f6fcdb09a8a02dfcd2e3d8fc9ce613f (diff)
Rename task CLI from ask to do
- Move cmd/ask to cmd/do; mage BuildDo builds binary named do - Update askcli help text, errors, Fish completion (complete -c do, __do_*) - Task alias cache path: XDG cache hexai/do/task-aliases-v2.json - Refresh README and docs; go install path cmd/do@latest - Remove accidentally tracked cmd/ask build artifact; ignore cmd/do/do and cmd/do/ask Made-with: Cursor
Diffstat (limited to 'docs/fish-completion.md')
-rw-r--r--docs/fish-completion.md22
1 files changed, 11 insertions, 11 deletions
diff --git a/docs/fish-completion.md b/docs/fish-completion.md
index d707b77..f55e4cf 100644
--- a/docs/fish-completion.md
+++ b/docs/fish-completion.md
@@ -1,34 +1,34 @@
# Fish Completion
-The `ask` task-management CLI embeds its Fish completion script in the binary and prints it with `ask fish`.
+The `do` task-management CLI embeds its Fish completion script in the binary and prints it with `do fish`.
-It completes the top-level `ask` subcommands and the nested `ask dep` operations.
-It also completes task selectors for UUID-taking commands by reading pending tasks through `ask complete-uuids`, which uses the local alias cache for stable short IDs.
+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.
-Selector suggestions stop once a command has consumed its selector argument, and `ask dep add` / `ask dep rm` suggest selectors for both task positions.
-When typing `ask add depends:...`, Fish also completes the comma-separated dependency selector list inside the `depends:` modifier.
+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.
Load it into the current Fish session:
```sh
-ask fish | source
+do fish | source
```
If you installed with `mage install` and `~/go/bin` is not on your `PATH` yet, use:
```sh
-~/go/bin/ask fish | source
+~/go/bin/do fish | source
```
To enable it automatically for new Fish sessions, add this to your Fish config or a file in `~/.config/fish/conf.d/`:
```fish
-set -l ask_bin ~/go/bin/ask
+set -l do_bin ~/go/bin/do
-if test -x $ask_bin
- $ask_bin fish | source
+if test -x $do_bin
+ $do_bin fish | source
end
```
-No external `ask.fish` file is required.
+No external `do.fish` file is required.