From b10c6247e14a3acfe20e78426e131691e205a601 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Thu, 26 Mar 2026 22:07:07 +0200
Subject: ask: add fish completions for task CLI

---
 docs/buildandinstall.md |  1 +
 docs/fish-completion.md | 20 ++++++++++++++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 docs/fish-completion.md

(limited to 'docs')

diff --git a/docs/buildandinstall.md b/docs/buildandinstall.md
index 3d70a4a..7e63ada 100644
--- a/docs/buildandinstall.md
+++ b/docs/buildandinstall.md
@@ -11,6 +11,7 @@ Hexai uses Mage for developer tasks. Install Mage, then run targets like build,
 - In restricted sandboxes/CI (no sockets), skip network-based tests:
   - `HEXAI_TEST_SKIP_NET=1 go test ./... -cover`
 - Install binaries to `GOPATH/bin`: `mage install`
+- Install Fish completions: `install -Dm644 assets/ask.fish ~/.config/fish/completions/ask.fish`
 
 Note: `mage lint` uses `golangci-lint`. Install via `mage devinstall` if needed.
 
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.
-- 
cgit v1.2.3