shogun-agent-status

Display AI agent operational status from tmux, task YAML, and inbox counts.

1.4k|293|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/yohey-w/multi-agent-shogun --skill shogun-agent-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shogun-agent-status
Source: https://github.com/yohey-w/multi-agent-shogun/tree/main/skills/shogun-agent-status
Command: npx skills add https://github.com/yohey-w/multi-agent-shogun --skill shogun-agent-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides a consolidated view of all AI agents' operational status, helping to quickly identify any issues or idle agents.

Core Features & Use Cases

  • Unified Status Display: Aggregates information from tmux pane status, task YAML files, and unread inbox counts.
  • Agent Health Check: Quickly determine if agents are running, idle, busy, or have unread messages.
  • Use Case: Before assigning new tasks, you can use this Skill to see which 'Ashigaru' agents are available and ready to work, ensuring efficient task distribution.

Quick Start

Run bash scripts/agent_status.sh to see the status of all agents.

Frequently Asked Questions about shogun-agent-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor the operational status of multiple AI agents in tmux?

You can monitor AI agent status by running a script that aggregates tmux pane states, task YAML file statuses, and unread inbox counts to display a unified view of all managers and workers.

How can I check if my multi-agent AI system has stalled processes?

To check for stalled processes in a multi-agent system, run a status script that integrates tmux pane states and task YAML files to identify whether agents are running, idle, busy, or unresponsive.

Does this agent status monitoring tool support both Claude Code and Codex CLIs?

Yes, the agent status monitoring tool supports both Claude Code and Codex CLIs, providing comprehensive oversight of multi-agent systems across these command line interfaces.

What is the best way to see which AI agents are available before assigning new tasks?

The best way to see available agents is to execute the agent status script, which checks tmux pane states and task YAML files to determine which agents are ready to work before task distribution.

Can I use task YAML files to determine agent availability in a multi-agent setup?

Yes, task YAML files are integrated with tmux pane states and unread inbox counts to accurately determine agent availability and health in a multi-agent setup.

Why do I need to aggregate tmux pane states and unread inbox counts for agent health checks?

Aggregating tmux pane states and unread inbox counts is necessary because it provides a consolidated view of agent health, revealing if agents are busy, idle, or have pending messages requiring attention.