hako-code
Single-file C terminal coding agent for local and cloud models with gated tools.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- System packages:
curl
download hako.sh proxy
curl -fsSL https://mithraeums.github.io/hako.sh -o /tmp/hako.sh && ls -lh /tmp/hako.sh && wc -l /tmp/hako.shdownload real install.sh
curl -fsSL "https://raw.githubusercontent.com/mithraeums/hako-code/main/install.sh" -o /tmp/install.sh && ls -lh /tmp/install.sh && wc -l /tmp/install.shinstall hako to ~/.local/bin
sh /tmp/install.sh && ls -lh ~/.local/bin/hako && ~/.local/bin/hako --version
Check that it works
hako --versionThe output should contain “hako v0.3.0 (build Oct 30 2026”.
First thing to try
hako -p "summarize README.md" --output-format jsonRun hako -p "summarize README.md" --output-format json in a project folder to give the agent a one-off task.
Linux x86_64
You need first
- System packages:
curl
Download installer proxy only
curl -fsSL https://mithraeums.github.io/hako.sh -o /tmp/hako.shDownload real installer script
curl -fsSL https://raw.githubusercontent.com/mithraeums/hako-code/main/install.sh -o /tmp/hako-install.shInstall hako via vetted script
sh /tmp/hako-install.sh
Check that it works
hako --helpThe output should contain “usage: hako [options]”.
First thing to try
hako --serve --port 8787 --no-colorcurl -sS http://127.0.0.1:8787/api/modelsRun hako -p "summarize README.md" --output-format json in a project folder to give the agent a one-off task.
What it does
- Run a coding agent in the terminalNot tested
- Use local models or cloud providersNot shown working
- Read and edit files and run shell commandsNot tested
- Keep sessions and use skillsNot tested
How far pickfit got
macOS arm64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Other systems
Good for
- list files in a directory
- summarize README.md
- score tool-call reliability with bench
An alternative to Hermes and Claude Code.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version v0.3.0
Differences the test machine hit
- README: curl -fsSL https://mithraeums.github.io/hako.sh | sh
In the test: hako.sh is a 4-line proxy that execs curl for https://raw.githubusercontent.com/mithraeums/hako-code/main/install.sh; downloaded both scripts and read before executing - README: hako --update pulls latest release
In the test: hako --update failed with 'could not fetch latest release' (transient GitHub API limit) even though install had just fetched v0.3.0 - README: install drops hako into /usr/local/bin (or ~/.local/bin)
In the test: on this unprivileged box it correctly chose ~/.local/bin/hako which is on PATH
Linux x86_64
Its service answers requests
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version v0.3.0
Differences the test machine hit
- README: curl -fsSL https://mithraeums.github.io/hako.sh | sh
In the test: downloaded proxy and real installer, read both, then ran local file; installer fetched a prebuilt binary tarball verified by sha256 which cannot be read as text - README: README badge shows v0.2.9
In the test: installed v0.3.0 reported as hako v0.3.0 - README: README documents :providers/:models/:sessions interactive commands
In the test: used hako --serve API paths /api/models and /api/sessions found by scanning binary; --help and README do not document them