OleksandrChekhovskyi /hax
A minimalist, terminal-native coding agent written in C.
★ 1,001⑂ 71👁 6⑃ 29● 45▤ 8
+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
#45Qwen 3.8, GLM 5.3 use shell/sed/python to read/write/edit files instead of the tools9 comments · 2026-09-23#51Add a Mistral provider: reasoning is a chunk list in both directions4 comments · 2026-10-08#50Add shortcuts to cycle through reasoning level and favorite models4 comments · 2026-10-03#16Feature request: Typing the next prompt while the current one is in progress4 comments · 2026-08-24#9feat: support direct shell commands4 comments · 2026-08-22#30Allow for colors and glyphs to be customized3 comments · 2026-09-05#34Up arrow always goes to previous prompt, should go up a line first2 comments · 2026-09-09#26feat: session title / alias2 comments · 2026-09-04
Latest release
hax v0.7.0 v0.7.0 2026-11-12Added - 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