Autocomplete for your terminal, in a dropdown.
As you type a command, hiruzen shows what the next word can be: subcommands, options, branches, files and scripts. You do not have to remember it.
Typing git ch opens a dropdown with checkout, cherry-pick and branch, each with a short description.
Three sources, ranked together
Command specs
The valid subcommands, options and arguments of more than 700 command-line tools, embedded in the binary.
Live context
Values from your machine, read when they are needed: git branches, tags and changed files, the scripts in package.json.
Your history
What you actually run moves to the top. If you always cherry-pick, it outranks checkout after you type git ch.
hiruzen starts your shell inside a pseudo-terminal and passes everything through to your real terminal. It draws the dropdown over the shell's output and restores what was underneath before the shell prints again, so the shell never sees a changed screen.
Running in three steps
Get the binary
macOS, and Linux with Homebrew.
Each release has prebuilt binaries for macOS (Apple silicon and Intel), Linux (x64 and arm64) and Windows (x64).
Try it
Starts your shell with suggestions switched on and changes no files. Type exit to leave.
Start it with every new terminal
Adds hiruzen to the startup file of every supported shell it finds. Open a new terminal afterwards. hiruzen uninstall removes exactly what this added.
Everything works locally
Settings and themes
One JSON file, changed with a command. Six dropdown themes: dark, light, dracula, nord, gruvbox and solarized.
hiruzen theme nordSaved scripts
A saved command with named blanks. Run it by name and you are asked for each blank.
hiruzen run restart service=apiShell plugins
Load prompts, aliases and functions into each new shell, from a git URL or a local directory.
hiruzen plugins add <url>Measure accuracy
Replays the newest fifth of your own history and reports how often the right word was suggested first.
hiruzen evaluateDoctor
Checks the installation, the settings file, each shell and the current terminal, and says how to fix what it finds.
hiruzen doctorWhere it runs
| Shell | Platforms | Status |
|---|---|---|
| zsh | macOS, Linux | Tested in live sessions |
| bash | macOS, Linux, Windows (Git Bash) | Tested in live sessions on macOS and Linux |
| fish | macOS, Linux | Tested in live sessions on Linux |
| PowerShell 7 | macOS, Linux, Windows | Tested in live sessions on Linux |
| Windows PowerShell 5 | Windows | Experimental |
| cmd | Windows | Experimental |
The unit tests pass on macOS, Linux and Windows. On Windows the dropdown has not yet been tried in a live terminal, so treat Windows support as experimental. On macOS, fish and PowerShell 7 are not yet tested; the same scripts pass on Linux. Nushell, Xonsh and other shells are not supported.
Offline by default
No network requests
hiruzen itself sends nothing anywhere. The completion specs are inside the binary.
What you type stays on your machine
Specs that would fetch suggestions from a registry or search service are refused unless you turn on autocomplete.onlineSuggestions.
History is read, never written
It reads the last 20,000 lines of your shell's history file at startup, keeps the session's commands in memory, and stores nothing on disk.
Spec code runs in a sandbox
Specs that compute suggestions with JavaScript run in an embedded engine with no file, network or timer access.
Live suggestions run read-only commands
Such as git, to list branches. Each one gets no input and is stopped after 3 seconds. A tool's own listing command may contact that tool's service: gh asks GitHub, kubectl asks your cluster.
Your shell always starts
If hiruzen cannot start, your shell opens as normal. Scripts and other non-interactive shells are not affected.
So Claude does not guess at flags
The repository is also a Claude Code plugin marketplace. The plugin lets Claude look up a tool's valid subcommands and options before it writes a command. Install hiruzen first, then in Claude Code:
/hiruzen:cli-lookupLooks up what can follow a partly typed command. Claude also uses it on its own when unsure of a flag.
/hiruzen:setupInstalls, checks or removes hiruzen and changes its settings. Runs only when you ask for it.
hiruzen also completes the claude command itself in your terminal: its options, subcommands, and values such as --permission-mode.
Questions? Answers
Does hiruzen send what I type anywhere?
Is it a replacement for Fig?
Does it work on Windows?
Are the suggestions always right?
Where do suggestions appear?
Can I change the keys?
How do I remove it?
Try it in your own terminal
hiruzen is free and open source under the MIT licence. If a tool gives no suggestions, or wrong ones, open an issue.
The completion specs come from Fig's open-source spec library, and the approach and shell integration scripts are adapted from Microsoft's inshellisense. Both are MIT licensed.