Deterministic terminal coding agent.
HooCode is a deterministic terminal coding agent — four scoped modes (Ask · Plan · Build · Debug), 25+ providers, hybrid search, and one-click plugins in a single binary. Nothing applies without your approval.
macOS / Linux
curl -fsSL https://kolisachint.github.io/hoocode/install.sh | shWindows
irm https://kolisachint.github.io/hoocode/install.ps1 | iexnpm (needs Node ≥ 20)
npm install -g @kolisachint/hoocode-agentThen:
hoocode --helpThe one-click installers need no root, install into ~/.hoocode, and pre-seed
the optional Rust helpers (fd, rg, embsearch, webtools, voicetools) so
your first session is fast even offline. Full details, including the standalone
archives and container setups, are in Install.
hoodemo_demo_native.mp4
Full documentation: kolisachint.github.io/hoocode
- Product — features, modes, tools, and extensibility
- Install — installation and building from source
- Contributing — how to get a change in (newcomers welcome)
- AGENTS.md — project-specific rules for humans and agents
| Package | Description |
|---|---|
| @kolisachint/hoocode-agent | Interactive coding agent CLI (hoocode / hoo) |
| @kolisachint/hoocode-agent-core | Agent runtime with tool calling and state management |
| @kolisachint/hoocode-ai | Unified multi-provider LLM API (OpenAI, Anthropic, Google, …) |
| @kolisachint/hoocode-tui | Terminal UI library with differential rendering |
Contributions are welcome — bug reports, ideas, docs fixes, a new tip, a whole provider. No approval needed before opening a PR.
Genuinely easy places to start:
- Add a tip — one row in an array. If you learned a trick the hard way, nobody else should have to.
- Fix a doc — if something confused you, it will confuse the next person.
- Write an example extension — self-contained, no core changes.
- good first issue — say "I'll take this" and it is yours.
See CONTRIBUTING.md. Questions are welcome as issues; for collaboration or anything that does not fit one, tag @kolisachint on X.
★ If HooCode is useful to you, star the repo. One click, and it is the single cheapest way to help other people find it.
HooCode is developed independently, but it began from the pi-mono project (originally badlogic/pi-mono) by Mario Zechner (@badlogicgames) and still contains work derived from it. The upstream project is MIT-licensed and all original copyright is preserved in LICENSE. Huge thanks to Mario and the upstream contributors — without their work, HooCode would not exist.
A small set of offline-first tools for agents:
- embeddingsearchtools — semantic + BM25 retrieval, HNSW from scratch (Rust)
- webtools — token-efficient web fetch and search (Rust)
- voicetools — offline speech recognition, mic to stdout (Rust)
Built by Sachin Koli.
MIT — see LICENSE.