---
name: Shogun Agent Status
slug: shogun-agent-status
category: AI Engineering
description: Shogun Agent Status displays the operational state of all agents (karō, ashigaru 1-7, strategist) by combining tmux pane status, task YAML status, and unread inbox counts. Use it to check which agents are idle, busy, or missing before assigning tasks.
github: "https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-agent-status"
language: Shell
stars: 1415
forks: 292
install: "npx degit https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-agent-status ~/.claude/skills/shogun-agent-status"
installs_to: ~/.claude/skills/shogun-agent-status
source_path: skills/shogun-agent-status/SKILL.md
collection_size: 7
category_size: 2451
collection_url: "https://dirskills.com/collections/yohey-w/multi-agent-shogun"
added: 2026-08-19T07:27:31.129Z
last_synced: 2026-08-19T07:27:31.129Z
canonical_url: "https://dirskills.com/skills/shogun-agent-status"
---

# Shogun Agent Status

Shogun Agent Status displays the operational state of all agents (karō, ashigaru 1-7, strategist) by combining tmux pane status, task YAML status, and unread inbox counts. Use it to check which agents are idle, busy, or missing before assigning tasks.

**Install:**

```bash
npx degit https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-agent-status ~/.claude/skills/shogun-agent-status
```

## README

# /agent-status - エージェント稼働確認

## Overview

全エージェントの稼働状態を2つのデータソースから統合判定して一覧表示する。

1. **Pane状態**: tmux capture-paneの末尾5行からCLI固有のidle/busyパターンを検出
2. **タスクYAML**: `queue/tasks/{agent}.yaml` のtask_idとstatus
3. **未読inbox**: `queue/inbox/{agent}.yaml` の未処理メッセージ数

Claude Code / Codex CLI 両方に対応。

## When to Use

- 「稼働確認」「エージェント状態」「布陣確認」と言われた時
- 足軽が暇そうか確認したい時
- タスク配分前に空いているエージェントを探す時
- 誰かが止まっているか調べたい時

## Instructions

以下のコマンドを実行する:

```bash
bash scripts/agent_status.sh
```

## 出力の読み方

| Column | 意味 |
|--------|------|
| Agent | エージェント名 |
| CLI | CLI種別（claude/codex） |
| Pane | tmux pane状態: 稼働中/待機中/不在 |
| Task ID | タスクYAMLのtask_id（---=未割当） |
| Status | タスクYAMLのstatus: assigned/done/idle等 |
| Inbox | 未読inboxメッセージ数 |

## 状態の解釈

- **Pane=待機中 + Status=done**: 完了済み、次タスク待ち。新タスク配分可能。
- **Pane=稼働中 + Status=assigned**: 正常にタスク実行中。放置してよい。
- **Pane=待機中 + Status=assigned**: タスク割当済みだがCLIが止まっている。要調査。
- **Pane=稼働中 + Status=done**: タスク完了後に別作業中（inbox処理等）。
- **Inbox > 0**: 未読メッセージあり。エージェントが処理していない可能性。
- **Pane=不在**: tmux paneが存在しない（shutsujin未実行 or pane killed）。