ask: add fish completions for task CLI

1 files changed, 20 insertions, 0 deletions

diff --git a/docs/fish-completion.md b/docs/fish-completion.md
new file mode 100644
index 0000000..116a0a6
--- /dev/null
+++ b/docs/fish-completion.md
@@ -0,0 +1,20 @@
+# Fish Completion
+
+Hexai ships a Fish completion file for the `ask` task-management CLI at [`assets/ask.fish`](../assets/ask.fish).
+
+It completes the top-level `ask` subcommands and the nested `ask dep` operations.
+The script also preserves the global `--json` flag.
+
+Install it into Fish's completion directory:
+
+```sh
+install -Dm644 assets/ask.fish ~/.config/fish/completions/ask.fish
+```
+
+If you use a custom XDG config directory, copy it to:
+
+```sh
+$XDG_CONFIG_HOME/fish/completions/ask.fish
+```
+
+The completion file is static and ships with the repository, so it does not require a build step.