summaryrefslogtreecommitdiff
path: root/docs/fish-completion.md
blob: 10966e9788c7731f1c42856bd6399f89a4826937 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# 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.
It also completes task UUIDs for UUID-taking commands by reading the current project from `ask all --json` and filtering out completed and deleted tasks.
The script 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.