Repository navigation
Releases
Releases · farhanmalhi/hiruzen-cli
0.1.0 - 2026-11-21
Release Notes
The first release. hiruzen shows a dropdown of what the next word of your
command can be, as you type it.
Added
- Dropdown autocomplete at the shell prompt. Suggestions for subcommands,
options and arguments appear under the cursor as you type.Tabaccepts,
UpandDownmove the highlight,Eschides the dropdown, andEnter
runs the command as typed. - Specs for 704 command-line tools, converted from Fig's spec library and
embedded in the binary. Large tools such asawsandgcloudhave
separate specs for their services. - Live suggestions from your machine: git branches, tags and changed
files, the scripts inpackage.json, and the values a tool's spec lists by
running the tool. - Ranking from your shell history, so the commands you actually run come
first. History is read, never written. - Fuzzy matching: exact prefix, case-insensitive prefix, substring, then
letters in order. - Shell support: zsh, bash, fish and PowerShell 7 on macOS and Linux;
PowerShell 7, Windows PowerShell 5, Git Bash and cmd on Windows. hiruzen installandhiruzen uninstalladd hiruzen to your shell's
startup file and remove it again.hiruzen init <SHELL>prints the line to
add by hand, andhiruzen integrations statusshows which shells start
hiruzen.hiruzen settingslists, reads and changes settings: dropdown height,
descriptions, fuzzy search, history, commands to skip, and whetherEnter
accepts a suggestion. A running session picks up a change at its next
prompt.- Six colour themes:
dark,light,dracula,nord,gruvboxand
solarized.hiruzen theme --listpreviews them. hiruzen doctorchecks the installation, the settings file, each shell
and the current terminal, and says how to fix what it finds.hiruzen complete <COMMAND>prints the suggestions for a partly typed
command without starting a session.hiruzen issueopens a GitHub issue form with your system details
filled in.- Saved scripts. A script is a saved command with named blanks, kept as
a plain file.hiruzen run <NAME>asks for each blank and runs it, and
hiruzen scriptscreates, edits, shows and removes them. - Shell plugins.
hiruzen plugins addloads a directory of shell code
(prompts, aliases, functions) into each new shell, from a local path or a
git URL.hiruzen plugins updatepulls the cloned ones. hiruzen evaluatemeasures how often the word you typed next was the
first suggestion, in the top three or in the top eight, by replaying your
own shell history. It prints totals only and runs no commands.- Prebuilt binaries for macOS (Apple silicon and Intel), Linux (x64 and
arm64) and Windows (x64), installed with Homebrew
(brew install farhanmalhi/tap/hiruzen) or with the shell and PowerShell
installer scripts attached to each release.
Privacy and security
- hiruzen makes no network requests while you type. Suggestions that a spec
would fetch from the network are not offered. The one command that uses the
network ishiruzen plugins add <URL>, which runsgit clonebecause you
asked it to. - JavaScript in specs runs in a sandbox with no file, network or timer
access. The commands it asks hiruzen to run get no input, are stopped after
3 seconds, and come from the embedded spec library only. - If hiruzen cannot start, your shell opens as normal.
Known limitations
- Windows is experimental. It builds and passes the unit tests, but the
dropdown has not yet been tried in a live Windows terminal. - fish and PowerShell 7 on macOS are not tested; the same scripts pass on
Linux. - In a pipeline, only the last command is completed.
- The keys cannot be rebound.
- Six tools (
az,heroku,shopify,fig,infracostand
@usermn/sdc) build their spec at run time, so they have no spec;
suggestions for them come from your history and the current directory. - Nushell, Xonsh and other shells not listed above are not supported.
Install hiruzen-cli 0.1.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/farhanmalhi/hiruzen-cli/releases/download/v0.1.0/hiruzen-cli-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/farhanmalhi/hiruzen-cli/releases/download/v0.1.0/hiruzen-cli-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install farhanmalhi/tap/hiruzenDownload hiruzen-cli 0.1.0
| File | Platform | Checksum |
|---|---|---|
| hiruzen-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| hiruzen-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| hiruzen-cli-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| hiruzen-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| hiruzen-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
| hiruzen-cli-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| hiruzen-cli-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |
0.1.0-rc.1 - 2026-11-21
Release Notes
The first release. hiruzen shows a dropdown of what the next word of your
command can be, as you type it.
Added
- Dropdown autocomplete at the shell prompt. Suggestions for subcommands,
options and arguments appear under the cursor as you type.Tabaccepts,
UpandDownmove the highlight,Eschides the dropdown, andEnter
runs the command as typed. - Specs for 704 command-line tools, converted from Fig's spec library and
embedded in the binary. Large tools such asawsandgcloudhave
separate specs for their services. - Live suggestions from your machine: git branches, tags and changed
files, the scripts inpackage.json, and the values a tool's spec lists by
running the tool. - Ranking from your shell history, so the commands you actually run come
first. History is read, never written. - Fuzzy matching: exact prefix, case-insensitive prefix, substring, then
letters in order. - Shell support: zsh, bash, fish and PowerShell 7 on macOS and Linux;
PowerShell 7, Windows PowerShell 5, Git Bash and cmd on Windows. hiruzen installandhiruzen uninstalladd hiruzen to your shell's
startup file and remove it again.hiruzen init <SHELL>prints the line to
add by hand, andhiruzen integrations statusshows which shells start
hiruzen.hiruzen settingslists, reads and changes settings: dropdown height,
descriptions, fuzzy search, history, commands to skip, and whetherEnter
accepts a suggestion. A running session picks up a change at its next
prompt.- Six colour themes:
dark,light,dracula,nord,gruvboxand
solarized.hiruzen theme --listpreviews them. hiruzen doctorchecks the installation, the settings file, each shell
and the current terminal, and says how to fix what it finds.hiruzen complete <COMMAND>prints the suggestions for a partly typed
command without starting a session.hiruzen issueopens a GitHub issue form with your system details
filled in.- Saved scripts. A script is a saved command with named blanks, kept as
a plain file.hiruzen run <NAME>asks for each blank and runs it, and
hiruzen scriptscreates, edits, shows and removes them. - Shell plugins.
hiruzen plugins addloads a directory of shell code
(prompts, aliases, functions) into each new shell, from a local path or a
git URL.hiruzen plugins updatepulls the cloned ones. hiruzen evaluatemeasures how often the word you typed next was the
first suggestion, in the top three or in the top eight, by replaying your
own shell history. It prints totals only and runs no commands.- Prebuilt binaries for macOS (Apple silicon and Intel), Linux (x64 and
arm64) and Windows (x64), installed with Homebrew
(brew install farhanmalhi/tap/hiruzen) or with the shell and PowerShell
installer scripts attached to each release.
Privacy and security
- hiruzen makes no network requests while you type. Suggestions that a spec
would fetch from the network are not offered. The one command that uses the
network ishiruzen plugins add <URL>, which runsgit clonebecause you
asked it to. - JavaScript in specs runs in a sandbox with no file, network or timer
access. The commands it asks hiruzen to run get no input, are stopped after
3 seconds, and come from the embedded spec library only. - If hiruzen cannot start, your shell opens as normal.
Known limitations
- Windows is experimental. It builds and passes the unit tests, but the
dropdown has not yet been tried in a live Windows terminal. - fish and PowerShell 7 on macOS are not tested; the same scripts pass on
Linux. - In a pipeline, only the last command is completed.
- The keys cannot be rebound.
- Six tools (
az,heroku,shopify,fig,infracostand
@usermn/sdc) build their spec at run time, so they have no spec;
suggestions for them come from your history and the current directory. - Nushell, Xonsh and other shells not listed above are not supported.
Install hiruzen-cli 0.1.0-rc.1
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/farhanmalhi/hiruzen-cli/releases/download/v0.1.0-rc.1/hiruzen-cli-installer.sh | shInstall prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/farhanmalhi/hiruzen-cli/releases/download/v0.1.0-rc.1/hiruzen-cli-installer.ps1 | iex"Install prebuilt binaries via Homebrew
brew install farhanmalhi/tap/hiruzenDownload hiruzen-cli 0.1.0-rc.1
| File | Platform | Checksum |
|---|---|---|
| hiruzen-cli-aarch64-apple-darwin.tar.xz | Apple Silicon macOS | checksum |
| hiruzen-cli-x86_64-apple-darwin.tar.xz | Intel macOS | checksum |
| hiruzen-cli-x86_64-pc-windows-msvc.zip | x64 Windows | checksum |
| hiruzen-cli-aarch64-unknown-linux-gnu.tar.xz | ARM64 Linux | checksum |
| hiruzen-cli-x86_64-unknown-linux-gnu.tar.xz | x64 Linux | checksum |
| hiruzen-cli-aarch64-unknown-linux-musl.tar.xz | ARM64 MUSL Linux | checksum |
| hiruzen-cli-x86_64-unknown-linux-musl.tar.xz | x64 MUSL Linux | checksum |