dirac-run/dirac

Dirac – オープンソースの AI コーディングエージェント

Dirac は、大規模なコードベース全体で開発者がコードを作成、リファクタリング、管理するのを支援するように設計された、プログラム可能な AI アシスタントです。VS Code（Agent Client Protocol をサポートする任意のエディタ）、コマンドライン、または JetBrains や Zed などの ACP 互換 IDE を介して実行できます。

Dirac の違いは何か？

機能	重要性
プロバイダー非依存	数十の LLM プロバイダー（OpenAI、Anthropic、Gemini、Groq、Mistral など）と任意のカスタムエンドポイントで動作します。既存の認証情報をそのまま使用できます。
ゴールモード	単一の高レベル目標（/goal <objective>）を与えると、Dirac は目標が達成されるまで数時間にわたって作業を続け、サブタスクを作成および調整します。いつでも一時停止、操作、停止が可能です。
ハッシュアンカーによるファイル編集	壊れやすい検索置換の代わりに、Dirac は各行に安定したハッシュをタグ付けします。編集は正確なアンカーを対象とするため、他の近くの変更の影響を受けず、消費トークンも大幅に少なくなります。
AST ベースの検査と操作	エージェントはファイルの概要を要求したり、特定の関数の実装を取得したり、生のテキストではなく抽象構文木を使用してリポジトリ全体のシンボルを置換/名前変更したりできます。
並列バッチ操作	複数の独立した読み取り、検索、編集、シェルコマンドを単一のモデル応答にまとめることができ、ラウンドトリップとレイテンシを削減します。
サブエージェント	独立したエージェント（例：1つは調査、もう1つは編集）を、それぞれ独自のプロンプト、ツール、タイムアウトで並行して実行できます。Dirac は鮮度を追跡して、古い書き込みを防ぎます。
ユーティリティモデル	より安価な「ユーティリティ」モデルが、コンテキスト圧縮、コミットメッセージ生成、権限チェックなどの安価な作業を処理し、メインモデルは重いコーディングに集中できます。
低冗長モード	モデルの雑談をオフにして、決定、検証結果、最終的な差分のみを表示します。
権限と承認ワークフロー	自動承認は自然言語ポリシーで管理できます。不確実なことはユーザーにエスカレーションされ、トランスクリプトに記録されます。
継続性とチェックポイント	長時間実行されるタスクはチェックポイントで保存されます。後で再開したり、以前のワークスペース状態を復元したり、保存されたポイントからタスクを再生したりできます。

典型的なワークフロー

1. インストール – VS Code 拡張機能、npm CLI（npm install -g dirac-cli）、またはエディタの ACP レジストリから Dirac を追加します。
2. プロバイダーを設定 – モデルを選択し、API キーを提供します（OPENAI_API_KEY、ANTHROPIC_API_KEY などの環境変数がサポートされています）。
3. セッションを開始 – UI またはターミナルで /goal "Add logging to all HTTP handlers" と入力します。
4. 作業を監視 – Dirac はタスクを計画し、AST を検査し、正確な編集を行い、テストを実行し、マルチファイルの差分を報告します。
5. 操作または承認 – 変更が必要な場合はメッセージを送信します。権限リクエストが表示された場合は、ポリシーに従って承認または拒否します。
6. 完了 – エージェントは受け入れ基準を検証し、チェックポイントを作成し、変更を自動的にコミットできます。

ベンチマーク

Dirac は、実際のリポジトリ（VS Code、Transformers、Django）からの 8 つのマルチファイルリファクタリングタスクで、いくつかのオープンソースエージェントハーネスと比較されました。同じ gemini-3-flash-preview モデルを使用して、Dirac は：

• 8 つすべてのタスクを完了（100% 成功）しましたが、次点のハーネスは 6-8 タスクで成功しました。
• 最低の平均トークンコストを達成 – タスクあたり 0.18 ドル、競合他社は 0.38-0.73 ドルでした。

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

インターフェース	コマンド / リンク
VS Code / Open VSX	Visual Studio Marketplace または Open VSX から Dirac をインストールします。
CLI	npm install -g dirac-cli（Node 22-24 が必要）。
ACP エディタ	エディタの ACP レジストリからインストールするか、dirac --acp を実行します。

CLI 使用例

# 一度認証する
dirac auth
# 簡単な分析
ndirac "Analyze the architecture of this project"
# ゴールモード – 無人
ndirac --yolo "Fix the failing tests"
# git diff を Dirac にパイプしてレビュー
git diff | dirac "Review this"

拡張性

• カスタムツール – /new-tool <description> で小さなユーティリティを記述できます。Dirac はそれを生成、コンパイル、検証し、すぐに利用可能にします。
• サブエージェント – それぞれ独自のツールセットとタイムアウトを持つ複数のエージェントを並行して実行します。
• リポジトリ認識フック – パスベースのルール、スキル、ワークフローを定義して、すべてのタスクに自動的に影響を与えます。

コミュニティと開発

• Apache 2.0 の下でオープンソース – Cline プロジェクトのフォーク。
• 貢献を歓迎します。lint、テスト、ビルド手順については CONTRIBUTING.md を参照してください（npm run install:all、npm run compile）。
• Star 履歴は安定したコミュニティの関心を示しています。

---

要約： Dirac は、大規模言語モデルが実際のコードベースを確実に、大規模に、そしてコストと自律性を細かく制御しながら編集するために必要なツールを提供する、フル機能でプロバイダーに依存しない AI コーディングエージェントです。