HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: MicroCodex Coding Agent – OpenAI/codexをC++で再実装、バイナリサイズ1MB未満

Show HN: MicroCodex Coding Agent – OpenAI/codex reimplemented in C++ <1MB binary (github.com)

11 pointsby paoloanzn3 コメント

要約

MicroCodexは、ローカルターミナルで動作する超軽量コーディングエージェントです。C++23で書かれており、ワンショットプロンプト、インタラクティブなターミナルUI、ローカルコーディングツール、永続的な会話、自動コンテキスト圧縮を提供します。OpenAI Codexの機能を模倣しつつ、ローカル環境での実行と軽量性を重視しています。

全文翻訳

MicroCodex は、ターミナルでローカル実行できる超軽量なコーディングエージェントです。

[画像: MicroCodexのスプラッシュ画面]

MicroCodexはC++23で記述されており、ワンショットプロンプト、インタラクティブなターミナルUI、ローカルコーディングツール、永続的な会話、自動コンテキスト圧縮を提供します。


クイックスタート

MicroCodexのインストールと実行

MacまたはLinuxで以下のコマンドを実行してMicroCodexをインストールします。

curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | sh

その後、microcodex login を実行してサインインし、microcodex を実行して開始します。

最新のGitHubリリースにアクセスして、お使いのプラットフォームに適したバイナリをダウンロードすることもできます。

各GitHubリリースには以下の実行ファイルが含まれています。

  • macOS
    • Apple Silicon/arm64: microcodex-aarch64-apple-darwin.tar.gz
    • x86_64: microcodex-x86_64-apple-darwin.tar.gz
  • Linux
    • x86_64: microcodex-x86_64-unknown-linux-gnu.tar.gz
    • arm64: microcodex-aarch64-unknown-linux-gnu.tar.gz

各アーカイブにはプラットフォーム名が埋め込まれた単一のエントリ(例: microcodex-aarch64-apple-darwin)が含まれているため、展開後に microcodex にリネームするのが一般的です。

インストーラーは現在のアーキテクチャのネイティブビルドを選択します。LinuxではlibcurlとOpenSSLのランタイムライブラリが必要です。

特定のリリースをインストールするには、MICROCODEX_RELEASE を設定します。

curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | MICROCODEX_RELEASE=v0.1.0 sh
ChatGPTプランでのMicroCodexの使用

microcodex login を実行し、表示されたURLをブラウザで開きます。リモートまたはヘッドレスマシンでは、microcodex login --device-auth を実行し、表示されたワンタイムコードを認証URLで入力します。MicroCodexは、結果のOAuth認証情報を $CODEX_HOME(CODEX_HOMEが未設定の場合は~/.codex)の下に保存します。

その後、インタラクティブセッションを開始したり、ワンショットプロンプトを渡したりできます。

microcodex
microcodex "Find the failing test, fix it, and run the relevant test suite"

モデルの思考の深さを選択するには、--effort フラグを渡すか、MICROCODEX_EFFORT 環境変数を設定します(両方が指定された場合はフラグが優先されます)。

microcodex --effort high "Find the failing test, fix it, and run the relevant test suite"

受け入れられる値は none, minimal, low, medium, high, xhigh, max, ultra, persistent で、デフォルトは medium です。空または不明な値はエラーとして拒否されます。この値は、公式Codexクライアントが使用する reasoning.effort フィールドとしてAPIに送信されます。

警告

MicroCodexはサンドボックスではありません。ユーザーのシェルを開始する前に、強制的なファイル削除(rm -f/rm -rf)、git reset --hard、強制的なgit clean、git checkout --、ディスクフォーマットツール、シャットダウンコマンドをブロックする簡単なレキシカル拒否リストを適用します。このガードはシェルパーサーではなく、完全なセキュリティ境界ではありません。拒否リストに一致しないコマンドやすべてのファイル操作は、MicroCodexプロセスと同じ権限で実行されます。

CodexスキルでのMicroCodexの使用

MicroCodexは、Codex用にインストールされたものと同じファイルシステムスキルを $CODEX_HOME/skills(CODEX_HOMEが未設定の場合は~/.codex/skills)の下で検出します。各スキルには、nameとdescriptionを含むYAMLフロントマターを持つ SKILL.md が必要です。スキルのメタデータはセッション開始時にエージェントの指示に追加されます。スキルの本体は、その名前または説明がタスクと一致した場合にのみ読み込まれます。

ソースからのビルド

ビルドには、C++23コンパイラ、make、libcurl開発ファイル、およびLinux上のOpenSSL開発ファイルが必要です。

git clone --recurse-submodules https://github.com/paoloanzn/microcodex.git
cd microcodex
make

実行ファイルは build/microcodex に書き込まれます。テストスイートは make test で実行します。

既知のバグと問題

  • すべての問題を閲覧
  • MCPサポートはまだ実装されていません。
  • MicroCodex使用中にターミナルからテキストをコピーできません。
  • bashの安全ゲートはレキシカル拒否リストであり、完全な安全コマンドポリシーやサンドボックスではありません。間接的または認識されない破壊的なコマンドはブロックされない可能性があります。

ドキュメント

このリポジトリはApache-2.0ライセンスの下でライセンスされています。