バックグラウンドセッションを一覧で監視したい
9. エージェントコマンド / 機能
claude agents [--json] [--all]並列バックグラウンドセッションの監視ビュー
概要
claude agents コマンドは、現在動いている（または過去の）並列バックグラウンドセッションを一覧表示する監視ビューです。--json でスクリプト向けの構造化出力、--all で終了済みセッションも含めた全件表示ができます。
設定例
# 実行中のバックグラウンドセッションを一覧表示
claude agents
# JSON で出力（スクリプト処理向け）
claude agents --json
# 終了済みも含めて全件表示
claude agents --all
# 特定セッションの詳細操作は他のサブコマンドと組み合わせる
claude attach <id> # セッションにアタッチ
claude logs <id> # ログを表示
claude stop <id> # 停止（エイリアス: kill）
claude rm <id> # 削除こんな時に使う
- 並列で走っているバックグラウンドエージェントの状態を確認したい時
- CI やダッシュボードからバックグラウンドセッションを監視したい時
- 終了したセッションも含めて履歴を確認したい時
使い方
- 1claude agents を実行して一覧を表示
- 2--json を付けると機械可読な JSON で出力される
- 3--all を付けると完了・失敗済みのセッションも表示
- 4id を控えて claude attach / logs / stop / rm と組み合わせる
Tips
- claude daemon status でバックグラウンドセッションを監督するデーモンの状態も確認できる
- claude respawn <id> で失敗したセッションを再起動できる
- --json は他ツールとの連携やアラート監視の自動化に便利