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ワンショットモードでのクリーンなstdout、stderrへの再開ヒント、プレーンテキストの設定・セッションファイル、プラグインではなくサブプロセスによる構成。

対象ユーザー

ターミナルで作業し、ローカルモデルを実行し、ツールの動作を監査し、ディストリビューション用にソフトウェアをパッケージングする開発者、またはリソースが限られた環境でエージェントを実行する開発者向けです。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を参照してください。