Adds your current lane, save count, storage size, and version to your zsh prompt. Tab-completes every Koh command and flag. No framework required.
Install the plugin curl -fsSL https://koh.asha.software/shell/install.sh | sh Downloads the latest koh.plugin.zsh from kepr.uk/koh (falling back to koh.asha.software), verifies its SHA-256 checksum, installs it to ~/.zsh/plugins/koh/, and adds the source line to ~/.zshrc only once.
Reload your shell source ~/.zshrc That's it. Open any project with a Koh repo and your prompt updates automatically.
Manual install (Antidote or bare zsh) mkdir -p ~/.zsh/plugins/koh && curl -fsSL https://koh.asha.software/shell/koh.plugin.zsh -o ~/.zsh/plugins/koh/koh.plugin.zsh printf '\nsource "$HOME/.zsh/plugins/koh/koh.plugin.zsh"\n' >> ~/.zshrc Requires sqlite3 in PATH (present by default on macOS; apt install sqlite3 on Linux). The plugin is prompt-only: it reads local Koh metadata and does not mutate your repository.
| Segment | When shown |
|---|---|
| kiln | Directory name (shortened to last 2 segments on deep paths) |
| on dev | Current lane — amber for dev, green for main |
| [!] | Working tree modified since last save. [+] if unsaved new files, [!+] for both |
| v1.17.0 | Package version on clean HEAD — only shown when the working tree is clean |
| · 6 saves | Save count for the current lane |
| · 4.2 MB | Total repository storage — green below 50 GB, red above |
Set any of these in your ~/.zshrc before sourcing the plugin.
| Variable | Default | What it controls |
|---|---|---|
| KOH_COLOR_DEV | yellow | Dev lane color |
| KOH_COLOR_MAIN | green | Main lane color |
| KOH_COLOR_DIRTY | red | Dirty indicator color |
| KOH_COLOR_DIR | cyan | Directory name color |
| KOH_SHOW_SAVES | true | Show save count segment |
| KOH_SHOW_SIZE | true | Show storage size segment |
| KOH_SHOW_PACKAGE | true | Show package version on clean HEAD |
| KOH_PROMPT_CHAR | → | Prompt character |
The plugin registers a compdef for koh. All commands complete out of the box. For commands that take save IDs (load, peek, pluck, diff), completions are pulled live from the local .koh/koh.db — you get the last 20 saves with their messages.
Flag and recovery commands complete out of the box, including flag, unflag, flags, revert, remote, offer, offers, issues, issue, report, and dashboard. The unbundle command completes *.koh.bundle files and apply completes *.koh.face files.