MadoHub Docs

Agent 検出

MadoHub が実行中の AI Agent を特定し、その状態を追跡する仕組み。

MadoHub は端末出力をリアルタイムに監視し、どの AI Agent が動作しているか、また現在どのような状態にあるかを自動検出します。これにより、タイルタイトルバーの視覚インジケーターやルーティング接続のトリガーが機能します。

サポートされている Agent

Claude Code

ターミナル出力に含まれる Unicode マーカーによって検出されます:

マーカー意味
❯ (U+2770)Claude Code プロンプト
✽ (U+273D)思考・処理インジケーター
⏺ (U+23FA)ツール利用インジケーター

また、出力内の文字列 "Claude Code" にも一致します。

OpenAI Codex CLI

一般的な CLI のシグネチャによって検出されます:

  • OpenAI Codex — ブランド表示行
  • codex> — TUI プロンプト
  • openai/codex — パッケージ参照
  • codex v[0-9] — バージョン文字列
  • > _ OpenAI Codex — 起動バナー
  • 実行モデルおよび各種実行パラメータ

Amp および OpenCode

Amp と OpenCode のセッションは、ワークスペースのネイティブプロセス監視を通じて自動的に識別され、開発環境における幅広い CLI ツールチェーンをカバーします。

一般的なシェル

Agent マーカーが検出されない場合、ターミナルは高性能な標準シェルセッションとして扱われます。

Agent の状態

MadoHub は各ターミナルのライフサイクルを 7 つの状態で継続的に追跡します:

状態状態の説明視覚効果
Workingコード生成、推論、またはツールの呼び出しをアクティブに実行中緑のパルス枠
Idle新たなユーザー入力を待機中標準枠 / 通常表示
Waiting権限の承認やユーザーの確認待ちオレンジの強調枠
Stopped実行が一時停止またはタスクターンが終了赤のインジケーター
Completedタスクが正常終了したことを確認緑の成功インジケーター
Failedエラーにより実行が中断赤のエラーインジケーター
Exited基盤のターミナルセッションが終了グレー / 暗色表示

MadoHub はリアルタイムのターミナルストリーム解析と構造化セッションログの検証を組み合わせ、状態遷移の即時性と高い信頼性を両立しています。

インテリジェントな完了検出

AI コーディングエージェントはバージョンによって多様な出力表現でタスク完了を提示します。MadoHub は固定のキーワードリストに依存せず、適応型のパターン認識エンジンによって完了タイミングを確実に特定します。

タスク完了が確認されると:

  1. Agent タイルの視覚インジケーターが即座に最新状態へと更新されます。
  2. 通知が有効な場合、エッジグローと通知音によって作業の完了が通知されます。
  3. 自動ルーティングトリガーが起動し、生成結果やコンテキストが後続のエージェントへとスムーズに引き渡されます。

On this page