A minimalist, terminal-native coding agent written in C.

★ 1,001⑂ 71👁 6⑃ 29● 45▤ 8
CMITCreated 2026-04-24usehax.dev
Download: hax v0.7.0hax-0.7.0 ↓0.7.02026-11-12
+2
Daily
1,001
stars
71
forks
6
watchers
29
prs
45
issues
8
releases

README

hax

A minimalist, terminal-native coding agent written in C.





 Key features

- Lightweight by design — A single native C binary with a small dependency set.
  Starts instantly and uses only a few MB of memory, leaving more RAM for local models.
- Local models are first-class — Start llama-server -m [model].gguf, then
  hax --provider llama.cpp, and hax auto-discovers the model and runtime capabilities.
  No custom provider config block is needed for the default setup.
- Respects your terminal — Streaming Markdown and live tool output, reflowed for display
  in the terminal. Only redraws the current streaming line or the input area, native scrollback
  is preserved. Does not take over or mess with your terminal.
- Inspectable — See exactly what was sent to the model and what it replied in a usable
  transcript view (Ctrl+T). Optionally collect a detailed wire protocol trace.
- Broad provider support — OpenAI (+compatible), Anthropic (+compatible), Codex (via a ChatGPT
  subscription), OpenRouter, OpenCode Zen/Go, DeepSeek, llama.cpp, Ollama, and custom endpoints.
- Well-behaved Unix tool — XDG paths, clean stdout in -p one-shot mode with resume hints on
  stderr, plain-text config and session files, composition via subprocesses instead of plugins.

 Target audience

Developers who live in the terminal, run local models, audit what their tools do, package
software for distros, or run agents where resources are scarce. If you want MCP marketplaces, a
plugin runtime, IDE panels, or per-command permission prompts, other agents build exactly that —
hax deliberately doesn't, and docs/philosophy.md explains each omission
and the pattern that covers the need.

If "fancy new AI tech in an old-school minimalist package" sounds like your vibe, you might
like this.

 Install

hax runs on Linux, macOS, FreeBSD, and OpenBSD; on Windows, use it under
WSL. The BSDs build from source only.

With Homebrew (macOS or Linux):

sh
brew install oleksandrchekhovskyi/hax/hax


On Arch Linux, hax is in the AUR as hax.

Alternatively, prebuilt binaries for Linux (x86_64 and aarch64) and macOS (Apple Silicon) are
available from the latest release:
unpack the hax binary into any directory on your PATH. The Linux binaries are fully static,
and the macOS one needs only libraries that ship with macOS. If macOS refuses to run a binary
downloaded through a browser, clear its quarantine flag with xattr -d com.apple.quarantine hax.

 From source

Building from source gives a binary linked against your system's shared libraries instead of
the libraries the prebuilt binaries bundle:

sh
git clone https://github.com/OleksandrChekhovskyi/hax.git
cd hax
scripts/install_deps.sh    Debian/Ubuntu, Fedora, Arch, openSUSE, Alpine, macOS, FreeBSD, OpenBSD
make                       the binary is now at ./build/hax
make install               optional; may prompt for sudo


scripts/install_deps.sh installs the build dependencies — a C compiler, libcurl,
jansson, meson, ninja, and pkg-config

Top issues

Latest release

hax v0.7.0 v0.7.0 2026-11-12
Added

- Man pages for offline reference: man hax for usage, plus hax-config(5), hax-sessions(5),
  and hax-providers(7). Packages and source builds install them; the prebuilt binaries do not.

 Changed

- A persistent, live-updating area below the conversation keeps the spinner, elapsed time, and
  status visible while hax works, even as answers stream and tools run. Pause requests show up
  immediately, and activity labels change without flickering.
- Compaction can now recover conversations that already exceed the context limit. Both /compact
  and automatic compaction can summarize a short

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON