Hax：用C语言编写的极简终端原生编程代理

Hax는 C로 작성된 미니멀하고 터미널 기반의 코딩 에이전트입니다. 단일 네이티브 바이너리로 제공되며 의존성이 적고, 즉시 시작되며 RAM을 수 MB만 사용하므로 로컬 LLM에 더 많은 메모리를 남겨둡니다.

주요 기능

• 설계상 경량: 작은 의존성 집합을 가진 단일 네이티브 C 바이너리. 즉시 시작되고 메모리 사용량이 매우 적습니다(수 MB에 불과). 따라서 로컬 LLM에 더 많은 RAM을 남겨둡니다.
• 로컬 모델 우선: Hax는 모델 및 런타임 기능을 자동으로 발견합니다. 기본 설정에 사용자 지정 제공자 구성 블록이 필요 없습니다. 예:

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

• 터미널 존중: 스트리밍 Markdown 및 실시간 도구 출력은 표시에 맞게 재정렬됩니다. 현재 스트리밍 줄 또는 입력 영역만 다시 그리며 네이티브 스크롤백을 보존합니다. 터미널을 가로채거나 엉망으로 만들지 않습니다.
• 검사 가능: 모델에 보낸 내용과 모델이 응답한 내용을 사용 가능한 대화록 보기(Ctrl+T)에서 정확히 확인할 수 있습니다. 선택적으로 상세한 와이어 프로토콜 추적을 수집할 수 있습니다.
• 모든 제공자/모델 사용: OpenAI(+호환), Anthropic(+호환), Codex(ChatGPT 구독을 통해), OpenRouter, llama.cpp 등을 지원합니다.
• 잘 작동하는 Unix 도구: XDG 경로, -p 일회성 모드에서 표준 출력은 깨끗하고 표준 오류에는 재개 힌트, 일반 텍스트 구성 및 세션 파일, 플러그인 대신 하위 프로세스를 통한 구성.

대상 사용자

터미널에서 생활하고, 로컬 모델을 실행하고, 도구가 수행하는 작업을 감사하고, 배포판용 소프트웨어를 패키징하거나, 리소스가 부족한 환경에서 에이전트를 실행하는 개발자. MCP 마켓플레이스, 플러그인 런타임, IDE 패널 또는 명령별 권한 프롬프트를 원한다면 다른 에이전트가 정확히 그런 기능을 구축합니다. Hax는 의도적으로 그렇게 하지 않으며, docs/philosophy.md에서 각 생략에 대해 설명합니다.

시작하기

Hax는 Linux 및 macOS에서 실행되며, Windows에서는 WSL에서 사용할 수 있습니다. Homebrew로 설치:

brew install oleksandrchekhovskyi/hax/hax

Arch Linux에서는 hax가 AUR에 hax로 있습니다. Linux에서는 최신 릴리스에서 사전 빌드된 정적 바이너리(x86_64 또는 aarch64)를 다운로드하여 PATH에 넣으십시오.

소스에서 빌드:

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

작업하려는 프로젝트 디렉토리에서 hax 실행:

hax                # 대화형 REPL
hax -p "list TODOs"  # 한 번의 프롬프트 실행 및 최종 답변 출력
printf "explain x" | hax -p   # 표준 입력에서 프롬프트 읽기
hax -c             # 이 디렉토리의 최신 세션 계속
hax --resume       # 이 디렉토리의 과거 세션 선택
hax --resume=ID -p "next"   # 특정 세션을 일회성 모드로 재개

가장 쉬운 첫 실행은 대화형입니다: hax를 시작한 다음 /provider를 사용하여 사용 가능한 제공자를 확인하고 모델을 선택하십시오. Hax는 대화형 제공자, 모델 및 노력 선택을 기억합니다. 제공자 설정 및 전체 문서는 README를 참조하십시오.