OleksandrChekhovskyi/hax

hax – 미니멀한 터미널 네이티브 코딩 에이전트

개요

• hax는 C로 작성된 작은 단일 바이너리 명령줄 도구로, 터미널에서 대규모 언어 모델(LLM)과 대화할 수 있습니다. OpenAI, Anthropic, Codex, OpenRouter, DeepSeek, llama.cpp, Ollama 등 다양한 제공업체를 지원하며, 즉시 시작되고 몇 메가바이트의 RAM만 사용하며 셸과 원활하게 작동하도록 설계되었습니다.

중요성

• 터미널에서 많은 시간을 보내고 무거운 IDE 플러그인이나 웹 UI의 오버헤드 없이 AI "어시스턴트"를 원하는 개발자에게 hax는 가볍고 감사 가능한 대안을 제공합니다. 설계는 투명성(정확한 요청/응답 기록을 볼 수 있음), Unix 스타일의 구성 가능성, 로컬 모델과의 쉬운 통합을 강조합니다.

주요 기능

• 가벼움 – 단일 네이티브 C 바이너리, Linux용 정적 빌드, 최소 런타임 종속성.
• 제공업체 중립 – 다양한 API를 기본 지원하며 llama-server 또는 ollama serve를 통한 로컬 모델을 일급 지원.
• 터미널 친화적 UI – 스트리밍 Markdown, 라이브 도구 출력, 터미널의 스크롤백을 존중하는 기록 보기(Ctrl+T).
• 검사 가능성 – 원시 와이어 프로토콜 교환을 덤프하거나 디버깅을 위한 상세 추적을 활성화할 수 있습니다.
• Unix 철학 준수 – XDG 기반 구성, 원샷 모드에서 깨끗한 표준 출력, 일반 텍스트 세션 파일, 플러그인 시스템 대신 하위 프로세스를 통한 구성.
• 확장 가능한 컴패니언 – 에이전트에서 호출할 수 있는 선택적 Python 도우미(웹 검색용 hax-web, MCP 관련 도구용 hax-mcp).

시작하기

1. 설치 – Homebrew(brew install .../hax), Arch AUR, 사전 빌드된 바이너리 또는 make로 소스에서 빌드.
2. 제공업체 연결 – hax를 시작하고 /provider 명령을 실행하고 모델을 선택합니다. 로컬 모델의 경우 llama-server -m model.gguf(또는 ollama serve)를 실행하기만 하면 됩니다.
3. 사용법 –
   • 대화형 REPL: hax
   • 원샷 프롬프트: hax -p "explain x"
   • 파이프 입력: printf "list TODOs" | hax -p
   • 이전 세션 다시 시작: hax --resume 또는 hax -c.
4. 구성 – 기본값을 위한 선택적 ~/.config/hax/config.toml(또는 유사); API 키용 환경 변수.

대상 사용자

• 터미널 중심의 개발자, 시스템 관리자, 로컬 LLM을 실행하며 빠르고 감사 가능한 AI 어시스턴트를 원하는 취미 사용자.
• Unix 관례를 따르고 작은 종속성 풋프린트를 가진 프로젝트를 다루는 패키저 및 배포판 관리자.
• 제한된 리소스(예: 저사양 노트북, 임베디드 Linux)를 가진 사용자로, 모델 자체에 대부분의 RAM을 남겨두는 에이전트가 필요한 경우.

라이선스

• MIT 라이선스로 배포됩니다.

---

모든 정보는 리포지토리의 README에서 직접 가져왔으며 추가 기능은 추측되지 않았습니다.