
2026/08/03 5:11
Show HN: MicroCodex コーディングエージェント – OpenAI の Codex を C++ で再実装し、バイナリサイズが 1MB 未満
RSS: https://news.ycombinator.com/rss
要約▶
日本語翻訳:
## サマリー:
MicroCodex は、C++23 で実装された極めて軽量なコーディングエージェントであり、ローカル端末環境で直接動作します。その主な利点は、リモートサーバー接続を必要とせずにインタラクティブな開発セッションを可能にし、ワンショットプロンプトを処理し、永続的な対話を維持できる点にあります。本ソフトウェアは、長期的な利用時の効率的性を確保するため自動コンテキスト圧縮機能を採用しており、Mac および Linux システム向けにスクリプトまたはバイナリによる簡素化されたインストールをサポートします。ただし、ユーザーはマシンが
libcurl や OpenSSL などの必須ランタイムライブラリを事前にインストール済みであることを確認する必要があります。ヘッドレスマシンにおいては、デバイス認証フローによって認証が処理されます。MicroCodex は破壊的なコマンド(例:rm -rf、git reset --hard)をブロックする辞書形式的な否認リストや OAuth ベースのログインシステムといった安全機能を含んでいますが、開発者はこれがサンドボックスではなく明示的であることを理解する必要があります。bash 安全性ゲートは完全なシェルパーサーとして動作しないため、本ツールは間接的なまたは認識されていないマルウェアコードに対するすべての保護を保証することはできません。したがって、安全なローカルアシスタンスには最適ですが、システムに与える総体的な害を防ぐ点での制限については、ユーザーが注意を払うべきです。本文
MicroCodex:ローカルターミナルで動作する軽量コーディングエージェント
MicroCodex は、C++23 で書かれた極めて軽量なコーディングエージェントです。以下の機能を備えています:
- ワンショットプロンプト対応
- インタラクティブなターミナル UI
- ローカルコーディングツール連携
- 耐久性のある会話履歴
- 自動コンテキスト圧縮機能
クイックスタート
インストールと実行方法
Mac または Linux でのインストール
以下のコマンドを実行して、システムアーキテクチャに合わせて自動的にネイティブビルドされた版をインストールします:
curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | sh
起動手順
- サインインを行う:
microcodex login - ブラウザで表示された URL を開く(または
フラグを使用)。--device-auth - セッションを開始:
またはワンショットプロンプトを渡す。microcodex
# インタラクティブセッション microcodex # ワンショットプロンプト microcodex "失敗しているテストを見つけ、修正し、関連するテストスイートを実行してください"
別なインストール方法(GitHub リリースから)
最新のリリースページからバイナリファイルをダウンロードすることも可能です。展開後、実行可能ファイルを
microcodex として名前変更することをお勧めします。
- macOS
- Apple Silicon/arm64:
microcodex-aarch64-apple-darwin.tar.gz - x86_64:
microcodex-x86_64-apple-darwin.tar.gz
- Apple Silicon/arm64:
- Linux
- x86_64:
microcodex-x86_64-unknown-linux-gnu.tar.gz - arm64:
microcodex-aarch64-unknown-linux-gnu.tar.gz
- x86_64:
特定のバージョンインストール 既定の最新リリースではなく、特定のバージョンをインストールしたい場合は、
MICROCODEX_RELEASE 環境変数を設定します:
curl -fsSL https://github.com/paoloanzn/microcodex/releases/latest/download/install.sh | MICROCODEX_RELEASE=v0.1.0 sh
OAuth サインイン詳細
を実行し、ブラウザで URL を開く。microcodex login- 遠隔マシンやヘッドレス環境の場合:
を実行し、ワンタイムコードを入力する。microcodex login --device-auth - クレデンシャルは
(デフォルト:$CODEX_HOME
)に保存されます。~/.codex
⚠️ 重要:セキュリティの注意点 MicroCodex は完全なサンドボックスではありません。以下の対策が適用されていますが、限界があります:
- シェル開始前に「強制ファイル削除(
)」、「ディスクフォーマット」など、危険なコマンドをブロックする辞書的ホワイトリストを使用しています。rm -f- このガードはシェルパーサーであり、完全なセキュリティ境界ではありません。
- ホワイトリストに一致しないコマンドやファイル操作は、MicroCodex プロセスと同じ権限で実行されます。
Codex スキルの使用方法
MicroCodex は
(デフォルト:$CODEX_HOME/skills
~/.codex/skills)にインストールされたファイルシステムスキルを認識します。
- 各スキルは
ファイルを持つ必要があります。SKILL.md
にはスキルの名前は、説明を含んだ YAML フロントマターを記載してください。SKILL.md- セッション開始時にスキルメタデータ(名前・説明)がエージェントに提示され、タスクと一致するまでスキル本体は読み込まれません。
ソースコードからのビルド
C++23 コマパイラー、
make が必要で、Linux 上では開発ファイルとして libcurl と OpenSSL も必要です。
git clone --recurse-submodules https://github.com/paoloanzn/microcodex.git cd microcodex make
- 実行可能ファイルは:
build/microcodex - テストスイート実行:
make test
既知のバグと制限事項
- MCP(Model Context Protocol)サポート: まだ実装されていません。
- コピー機能: ターミナルでのテキストコピーは現時点では利用できません。
- セキュリティ限界: Bash セーフティゲートは辞書的ホワイトリストに基づくため、間接的な破壊コマンドや認識できない危険コマンドがブロックされない可能性があります。
ドキュメントとライセンス
- ドキュメント項目
- CLI の使い方
- インストールとビルド
- テストスイート
- ライセンス: Apache-2.0