LiuMengxuan04/MiniCode

MiniCode – 軽量なターミナルファーストのコーディングアシスタント

それは何か – MiniCode は、Claude Code エージェントパターンを模倣したオープンソースのターミナルベースの AI コーディングアシスタントですが、コードベースは非常に小さいです。ローカルで実行され、LLM（Anthropic の Claude または Sidrune AI 統合 API を通じて公開される任意のモデル）と通信し、組み込みツール（ファイル編集、検索、シェルコマンド、Web フェッチなど）を呼び出してユーザーのリクエストを実行できます。

なぜ重要か – ほとんどの AI 搭載コーディングアシスタントは、大規模な Web サービスまたは重量級のデスクトップアプリです。MiniCode は意図的に小さく（数千行の TypeScript）保たれており、開発者はエージェントループ全体を読んで、変更し、拡張できます。したがって、以下に役立ちます：

• LLM ツール呼び出しエージェントがどのように配線されているかを学ぶ、
• クラウドプラットフォームなしでカスタムのプロジェクト固有のアシスタントを構築する、
• ターミナル UI でマルチステップのツールワークフロー、目標、計画を実験する。

コア機能

• モデル ↔ ツール ↔ モデルループ – 1 ターンで複数のツールを呼び出し、その結果を LLM にフィードバックし、最終回答を得ることができます。
• サブエージェント – 最大 3 つの読み取り専用ワーカーが並行して実行されます。ルートエージェントがすべてのファイル変更を所有します。
• メモリ内のプランと目標 – /plan はエージェントが更新する Todo リストを表示します。/goal はターンをまたいで存続する永続的な目標を作成します。
• ループ機能 – 同じプランを共有しながら、タイマー間隔でプロンプトを繰り返します。
• 全画面 TUI – トランスクリプトのスクロール、スラッシュコマンドメニュー、ファイル書き込み前の承認プロンプト。
• セッション永続化 – 各プロジェクトには独自の .mini-code/ フォルダがあります。セッションは再開、名前変更、またはフォークできます。
• コンテキスト管理 – 使用量優先の統計、自動圧縮、および過大なツール結果のスニッピング。
• 拡張可能なツールセット – ファイル操作、grep スタイルの検索、シェル実行、Web フェッチ、明確化プロンプト、および SKILL.md によるユーザー定義のスキル。

インストールとクイックスタート

# クローンしてインストール
git clone https://github.com/LiuMengxuan04/MiniCode.git
cd MiniCode
npm install
npm run install-local   # モデル名と Anthropic 資格情報を要求

# アシスタントを起動
minicode

モックモード（MINI_CODE_MODEL_MODE=mock）を使用すると、API キーなしで UI を試すことができます。

典型的なワークフロー

1. リクエストを入力 – 例：「parseJson の単体テストを追加」。
2. MiniCode はワークスペースを検査し、必要なツールを決定して呼び出します（ファイルの検索、テストランナーの実行など）。
3. LLM はツール出力を受け取り、プランを洗練し、ファイル変更を提案します。
4. TUI で差分をレビューします。MiniCode は書き込み前に確認を求めます。
5. 最終応答（要約、次のステップなど）が同じターミナルセッションに表示されます。

多言語エコシステム – リポジトリには TypeScript リファレンス実装がホストされています。Rust、Python、Go、Java にも同等のバージョンがあり、アーキテクチャが言語に依存しないことを示しています。

誰が背後にいるか – 創設者 Liu Mengxuan（TypeScript コア）、共同創設者 GateJustice（長時間セッションコンテキストシステム）、およびサブエージェント、メモリ層、言語ポートを担当する数人の貢献者。

詳細情報 –

• 使用ガイド（USAGE.md）– 完全なコマンドリファレンスと設定例。
• アーキテクチャ概要（ARCHITECTURE.md）– エージェントループ、メモリ層、ツールモデルを説明。
• デモページ – docs/index.html または GitHub-Pages サイトを開いて視覚的なウォークスルーを確認。

理想的なユーザー

• ターミナルのみの AI アシスタントを求める開発者。
• LLM 駆動のツール呼び出しパターンを研究する研究者や愛好家。
• クラウドプラットフォームのオーバーヘッドなしにカスタマイズ可能で自己ホスト型のコーディングヘルパーを必要とするチーム。

---

MiniCode は、コーディング支援に焦点を当てた本物の軽量 AI エージェントプロジェクトであり、一般的なチュートリアルリストや些細なデモではありません。