Mozzie

Mozzieとは？

Mozzieはローカルファーストのデスクトップアプリで、AIコーディングエージェントを管理された労働力として調整します。1回のエージェントセッションしか実行しないのではなく、作りたいものを記述すると、Mozzieが作業をアイテムに分割し、複数のエージェントを並列実行して、gitベースのワークフローを通じて出力を調整します。

アプリは作業と調整をあなたのマシンに留めます。各作業アイテムごとに独立したgit worktreeを作成し、アイテム間の依存関係を管理し、マージ前に変更を承認または拒否できるレビューフローを提供します。

主な機能

• オフライン対応のローカル実行: ローカルのSQLiteデータベースを使用し、エージェント実行ワークフローを含めすべてをあなたのマシン上で実行します。
• 自然言語による作業アイテム化: オーケストレータがリクエストを作業アイテムに変換し、実行順序を設定してエージェントを割り当てます。
• 並列マルチエージェント対応: 複数のコーディングエージェントを同時実行。Claude Code、Gemini CLI、Codex CLI、カスタムCLI/スクリプトの組み込みサポートを含む。
• 作業アイテムごとのgit worktree分離: 各作業アイテムを独自のworktreeとブランチで実行し、エージェント実行間の競合を低減。
• レビュー＋マージワークフロー: エージェント完了後、diff/レビューを表示。承認でoriginにプッシュ、拒否で次の試行にフィードバックを反映。
• 依存グラフとブロックアイテム自動起動: 作業アイテム同士の依存関係を設定。依存完了でブロックアイテムを自動起動し、サイクル検知付き。
• サブ作業アイテム（積み重ねブランチ）と親子マージ: 子ブランチを親作業アイテムにマージ。親が1つのPRとしてoriginにプッシュ。
• セッション横断の永続会話: オーケストレータのコンテキストを保持し、続きから再開可能。
• エージェント出力のリアルタイムストリーミング: エージェント出力をリアルタイムで監視。ツールコール活動の可視化を含む。

Mozzieの使い方

1. 前提条件のインストール: Node >= 20、pnpm >= 9、Rust (stable)、プラットフォーム固有のTauri前提条件を使用。少なくとも1つのAIコーディングエージェントCLIをインストール。
2. アプリのセットアップ:
   • リポジトリをクローンし、依存関係をインストール（pnpm install）。
   • 開発アプリを起動（pnpm dev）。アプリが開きます。
3. プロバイダとエージェントの設定:
   • 設定を開く（歯車アイコン）で、LLMオーケストレータプロバイダ（OpenAI、Anthropic、Gemini）のAPIキーを追加。
   • 実行したいコーディングエージェント（例: Claude Code、Gemini CLI、Codex、カスタム）のエージェント設定を追加。
4. 作業アイテムの作成と実行:
   • 作業アイテムを作成し、リポジトリを指定、エージェントを割り当てて実行開始。
   • またはコマンドバー（Ctrl+K）を開き、作りたいものを記述。オーケストレータが作業アイテムを作成してキューイング。
5. レビューとマージ:
   • 作業アイテムがレビュー段階に達したら、承認でoriginに変更をプッシュ。
   • 拒否でフィードバックを提供。Mozzieは全試行履歴と拒否理由を次のエージェントプロンプトに含めます。

ユースケース

• 機能リクエストを並列コーディングタスクに分割: コマンドバーで大きな変更を記述。Mozzieが作業アイテムに分割し、サポートエージェントを並列実行してレビュー可能なブランチを生成。
• エージェント出力を分離しつつリポジトリ作業: 複数アプローチを試す場合、各作業アイテムを独自のgit worktreeとブランチで実行し、エージェント同士の干渉を防ぐ。
• 多段階依存の処理（例: スキャフォールディング→実装）: 依存付き作業アイテムを作成。前提アイテム完了後にブロックアイテムを自動起動し、サイクル検知で循環計画を防止。
• 失敗後の構造化フィードバックによる反復: レビューで作業アイテムを拒否しフィードバックを追加。Mozzieが全試行履歴（拒否理由含む）を次の実行に注入し、同じミスを繰り返さない。
• 1回のアプリセッションで複数プロジェクト管理: マルチワークスペースサポートで、複数のリポジトリの作業アイテムを実行・レビュー。

FAQ

• Mozzieはクラウド接続が必要ですか？ Mozzieはローカルファーストで、完全にオフラインで動作します。

• どのAIコーディングエージェントを実行できますか？ リポジトリにClaude Code（ACP/stdio transport経由）、Gemini CLI、Codex CLI、カスタムCLI/スクリプトのビルトインサポートが記載されています。

• Mozzieはエージェント間の競合をどう防ぎますか？ 各作業項目ごとに独立したgit worktreeとブランチを作成するため、同時実行が同一ワーキングディレクトリを共有しません。

• レビュー中に作業項目を拒否したらどうなりますか？ Mozzieは完全な試行履歴と拒否理由を次のエージェントプロンプトに含め、状態をレビューから再実行パスに戻せます。

• 作業項目同士に依存関係は持てますか？ はい。Mozzieは依存グラフをサポートし、依存完了時にブロック項目を自動起動、サイクル検知も行います。

代替案

• シングルエージェントIDEツールやチャットベースのコーディングアシスタント：1回のエージェントセッションに限定する場合に便利。作業項目依存調整やgit worktree分離は通常提供されません。
• CLIに複数タスクを振り分けるローカルスクリプト実行ツール：エージェントコマンドを並列化可能ですが、オーケストレーション、依存管理、レビュー workflowは自分で構築する必要があります。
• コード生成とPRレビューのCI/CDベース自動化：レビューゲートとブランチングを扱えますが、インタラクティブなローカル「1ウィンドウ」オーケストレーションには向きません。
• ローカルファーストgit worktreeなしのAIエージェント向けワークフロー/オーケストレーションツール：エージェント呼び出しを調整可能ですが、Mozzieのgit worktree分離やスタックブランチマージ workflowは提供されない場合があります。