Hax: Um Agente de Codificação Minimalista e Nativo de Terminal em C

Hax é um agente de codificação minimalista, nativo do terminal, escrito em C. Ele vem como um único binário nativo com dependências mínimas, inicia instantaneamente e usa apenas alguns MB de RAM — deixando mais memória para seus LLMs locais.

Principais Recursos

• Leve por design: Um único binário nativo em C com um pequeno conjunto de dependências. Inicia instantaneamente e usa uma quantidade muito pequena de memória (apenas alguns MBs) — então mais RAM fica disponível para seus LLMs locais.
• Modelos locais são cidadãos de primeira classe: O Hax descobre automaticamente o modelo e os recursos do runtime. Nenhum bloco de configuração personalizado de provedor é necessário para a configuração padrão. Exemplo:

llama-server -m [modelo].gguf
hax --provider llama.cpp

• Respeita seu terminal: O streaming de Markdown e a saída de ferramentas ao vivo são reformatados para exibição. Apenas redesenha a linha atual de streaming ou a área de entrada, preservando o scrollback nativo. Não assume o controle nem interfere no seu terminal.
• Inspecionável: Veja exatamente o que foi enviado para o modelo e o que ele respondeu em uma visão de transcrição utilizável (Ctrl+T). Opcionalmente, colete um rastreamento detalhado do protocolo.
• Use qualquer provedor/modelo: Suporta OpenAI (+compatíveis), Anthropic (+compatíveis), Codex (via assinatura do ChatGPT), OpenRouter, llama.cpp, etc.
• Ferramenta Unix bem-comportada: Caminhos XDG, saída limpa no stdout no modo -p com dicas de retomada no stderr, arquivos de configuração e sessão em texto simples, composição via subprocessos em vez de plugins.

Para Quem É

Desenvolvedores que vivem no terminal, executam modelos locais, auditam o que suas ferramentas fazem, empacotam software para distros ou executam agentes em ambientes com recursos escassos. Se você quer marketplaces de MCP, runtime de plugins, painéis de IDE ou prompts de permissão por comando, outros agentes constroem exatamente isso — o Hax deliberadamente não constrói, e docs/philosophy.md explica cada omissão.

Começando

O Hax roda no Linux e macOS; no Windows, use-o sob WSL. Instale com o Homebrew:

brew install oleksandrchekhovskyi/hax/hax

No Arch Linux, o hax está no AUR como hax. Em qualquer Linux, baixe o binário estático pré-compilado (x86_64 ou aarch64) da versão mais recente e coloque-o no seu PATH.

Compile a partir do código-fonte:

git clone https://github.com/OleksandrChekhovskyi/hax.git
cd hax
scripts/install_deps.sh  # Debian/Ubuntu, Fedora, Arch, openSUSE, Alpine, macOS
make                     # binário em ./build/hax
make install             # opcional; pode pedir sudo

Execute o hax a partir do diretório do projeto em que deseja trabalhar:

hax                # REPL interativo
hax -p "listar TODOs"  # execute um prompt e imprima a resposta final
printf "explique x" | hax -p   # leia o prompt do stdin
hax -c             # continue a sessão mais recente para este diretório
hax --resume       # escolha uma sessão passada para este diretório
hax --resume=ID -p "próximo"   # retome uma sessão específica no modo one-shot

A primeira execução mais fácil é interativa: inicie hax e use /provider para ver os provedores disponíveis e escolher um modelo. O Hax lembra as seleções interativas de provedor, modelo e esforço. Veja o README para configuração do provedor e documentação completa.