summaryrefslogtreecommitdiff
path: root/docs/fish-completion.md
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-04-11 22:20:57 +0300
committerPaul Buetow <paul@buetow.org>2026-04-11 22:20:57 +0300
commit69d3ec004b8de3b9f7cfeb34686b9c344c787db4 (patch)
tree857101184293efa61f9d1caba4c3b80b31e89a37 /docs/fish-completion.md
parent5bc434d71fb5057131f1e5c0b2371db42d3b4ed4 (diff)
Rename task CLI binary from do back to ask
- Move cmd/do to cmd/ask; mage builds and installs ask; Fish completions to ask.fish - Update askcli help text, errors, executor default label, and Fish script (__ask_*) - Task alias cache subdirectory under XDG cache: hexai/ask/ - Rename integration test files and helpers; refresh README and docs - Rename plan-do-uuid-wrapper.md to plan-ask-uuid-wrapper.md Made-with: Cursor
Diffstat (limited to 'docs/fish-completion.md')
-rw-r--r--docs/fish-completion.md26
1 files changed, 13 insertions, 13 deletions
diff --git a/docs/fish-completion.md b/docs/fish-completion.md
index 19a90be..f8a4373 100644
--- a/docs/fish-completion.md
+++ b/docs/fish-completion.md
@@ -1,37 +1,37 @@
# Fish Completion
-The `do` task-management CLI embeds its Fish completion script in the binary and prints it with `do fish`.
+The `ask` task-management CLI embeds its Fish completion script in the binary and prints it with `ask fish`.
-It completes the top-level `do` subcommands and the nested `do dep` operations.
+It completes the top-level `ask` subcommands and the nested `ask 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.
-When typing `do add depends:...`, Fish also completes the comma-separated dependency selector list inside the `depends:` modifier.
+It also completes task selectors for UUID-taking commands by reading pending tasks through `ask complete-aliases`, which uses the local alias cache for stable short IDs.
+The `ask 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 `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.
The script preserves the global `--json` flag.
Load it into the current Fish session:
```sh
-do fish | source
+ask fish | source
```
If you installed with `mage install` and `~/go/bin` is not on your `PATH` yet, use:
```sh
-~/go/bin/do fish | source
+~/go/bin/ask 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 do_bin ~/go/bin/do
+set -l ask_bin ~/go/bin/ask
-if test -x $do_bin
- $do_bin fish | source
+if test -x $ask_bin
+ $ask_bin fish | source
end
```
-No external `do.fish` file is required.
+No external `ask.fish` file is required.
-If you installed with `mage install`, the installer also writes an autoloadable completion file to `~/.config/fish/completions/do.fish` (or `$XDG_CONFIG_HOME/fish/completions/do.fish`), so new Fish sessions should pick it up automatically.
+If you installed with `mage install`, the installer also writes an autoloadable completion file to `~/.config/fish/completions/ask.fish` (or `$XDG_CONFIG_HOME/fish/completions/ask.fish`), so new Fish sessions should pick it up automatically.