diff options
| author | Paul Buetow <paul@buetow.org> | 2026-04-11 22:20:57 +0300 |
|---|---|---|
| committer | Paul Buetow <paul@buetow.org> | 2026-04-11 22:20:57 +0300 |
| commit | 69d3ec004b8de3b9f7cfeb34686b9c344c787db4 (patch) | |
| tree | 857101184293efa61f9d1caba4c3b80b31e89a37 /docs/fish-completion.md | |
| parent | 5bc434d71fb5057131f1e5c0b2371db42d3b4ed4 (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.md | 26 |
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. |
