デーモンとランタイム
エージェントは Multica のサーバーでは実行されません — あなた自身のマシンで実行されます。
Multica では、エージェントは私たちのサーバーでは実行されません — ローカルにインストールされた AI コーディングツールを呼び出すデーモンという小さなプログラムが駆動し、あなた自身のマシンで実行されます。Multica サーバーは調整役に徹します。イシューを保存し、タスクをキューに入れ、適切なランタイムへ分配します（ランタイム = デーモン × AI コーディングツール 1 つ）。
この構造が Multica と Linear / Jira の最大の違いです。あなたの API キー、ツールチェーン、コードディレクトリはすべてあなたのマシンに残り、Multica サーバーはそのどれも見ることはありません。つまり「自分のエージェントが動かない」はほとんど常にローカルの問題です。デーモンが実行されていない、AI ツールがインストールされていない、キーが期限切れになっている、といったことです。まずローカルを確認してください。案内はトラブルシューティングを参照してください。
デーモンを起動する
デーモンは Multica CLI の一部です。Multica CLI をインストールしたら、あなた自身のマシンで実行してください。
multica daemon start起動時にデーモンは 4 つのことを行います。
- ログイン時に保存された認証情報を読み込みます
PATHにインストールされた AI コーディングツールを検出します（内蔵 12 種: Antigravity、Claude Code、Codex、Cursor、Copilot、Gemini、Hermes、Kimi、Kiro CLI、OpenCode、OpenClaw、Pi）- 検出した各ツールに対するランタイムとともに、自身をサーバーに登録します
- 3 秒ごとに取得すべきタスクがないかポーリングし、15 秒ごとにハートビートを送信し続けます
よく使うコマンド:
| コマンド | 用途 |
|---|---|
multica daemon start | 起動（デフォルトはバックグラウンド。フォアグラウンドで実行するには --foreground を追加） |
multica daemon stop | 停止 |
multica daemon restart | 再起動 |
multica daemon status | ステータス表示 |
multica daemon logs | ログ表示（追従するには -f を追加） |
完全な CLI リファレンスは CLI コマンドを確認してください。
デスクトップアプリにはデーモンが同梱されています。 デスクトップアプリを使う場合、multica daemon start を手動で実行する必要はありません。起動時にデーモンを自動的に立ち上げます。あなたのワークフローにどの方式が合うかは、デスクトップアプリページを参照してください。
1 つのマシンに複数のランタイムができる理由
ランタイムはサーバーでもコンテナでもありません。「デーモン × AI コーディングツール 1 つ」の組み合わせです。たとえば、Claude Code と Codex の両方がインストールされた MacBook でデーモンを起動し、あなたが 2 つのワークスペースのメンバーだとします。すると Multica は 4 つのランタイムを登録します。
要点:
- 1 つのデーモンは複数のランタイムにマッピングされ得ます — インストールされたツールと、あなたが所属するワークスペースの組み合わせごとに 1 つできます
- 同じデーモン、ワークスペース、ツールは、ちょうど 1 つのランタイムを作ります — デーモンを再起動しても重複レコードは生まれません
- Multica UI のランタイムページがこれらの行を一覧表示します
クラウドランタイムが近日提供されます。 現在は順番待ちリストの段階です。提供が始まれば、ローカルのデーモンを実行せずに Multica Cloud 上で直接エージェントタスクを実行できるようになります。ダウンロードページでメールアドレスを登録すると通知を受け取れます。
ランタイムがオフラインと表示される時点
Multica はハートビートでランタイムがオンラインかどうかを判断します。3 つの重要な数値があります。
| イベント | しきい値 |
|---|---|
| デーモンのハートビート頻度 | 15 秒ごと |
| 欠落として表示 | 45 秒間ハートビートなし（3 回欠落） |
| 自動削除 | 関連するエージェントがない状態で 7 日以上欠落 |
欠落は永続的ではありません。デーモンが再びハートビートを送った瞬間にオンラインに戻り、ランタイムレコードも保持されます。デーモンを再起動してもランタイムは失われません。
欠落したランタイムで実行中だったタスクは失敗として表示されます（失敗理由 runtime_offline）。リトライ可能なソース（イシュー、チャット）については、Multica が自動的に再度キューに入れます。オートパイロットがトリガーしたタスクは自動的にはリトライされません。タスク → どの失敗が自動リトライされるかを参照してください。
いくつのタスクを並列に実行できるか
Multica は 2 つの層で同時実行数の制限を適用します。
- デーモン層: デフォルトで同時タスク 20 個（環境変数
MULTICA_DAEMON_MAX_CONCURRENT_TASKSで調整可能） - エージェント層: デフォルトでエージェントあたり同時タスク 6 個（エージェントごとに設定）
2 つのうち厳しい方が適用されます。デーモンがすでにタスク 20 個を実行中なら、あるエージェントに余裕が残っていても新しいタスクは待機します。
タスクが dispatched に進めず queued で止まっている場合、通常はこの 2 つの制限のいずれかが飽和しています。
デーモンのクラッシュ後、進行中だったタスクはどうなるか
デーモンがクラッシュしたり強制終了されたりすると、デーモンが取得していたタスクは dispatched または running 状態に残ります。次回の起動時、デーモンはサーバーに「これらのタスクはもう私のものではないので、失敗として表示してください」と伝えます。サーバーはそれを理由 runtime_recovery とともに failed に切り替えます。リトライ可能なソースについては、タスクが自動的に再度キューに入ります。
この手順がネットワークの問題で失敗しても、バックアップとして30 秒ごとにサーバー側のスキャンが回ります。45 秒以上ハートビートのないランタイムは欠落として表示され、その上のタスクも一緒に回収されます。
動かないエージェントのトラブルシューティング
「自分のエージェントが動かない」という問題に遭遇したら、まずこの 3 ステップのチェックリストを進めてください。
multica daemon statusを実行し、デーモンが実行中でオンラインかを確認しますmultica daemon logs -fを実行し、エラーがないかを確認します- Multica UI のランタイムページを開き、ランタイムが「オンライン」と表示されているかを確認します
より多くのシナリオはトラブルシューティングを参照してください。