multi-agent-shogun is a multi-agent orchestration system designed to coordinate multiple AI coding agents working in parallel. Inspired by the hierarchy of a feudal Japanese military structure, the system organizes agents into roles such as Shogun, Karo, and Ashigaru, which correspond to strategist, coordinator, and worker agents. A user interacts primarily with the Shogun agent by issuing natural language instructions that describe the desired tasks. The system then automatically distributes work among multiple worker agents, allowing tasks to run simultaneously rather than sequentially. The architecture uses tools such as tmux sessions and file-based message queues to coordinate communication between agents while maintaining parallel execution. Developers can monitor the progress of the agent swarm through dashboards that show the status of tasks and worker activity in real time.
Features
- Hierarchical agent system using Shogun, Karo, and Ashigaru roles
- Parallel execution of multiple AI coding agents in coordinated workflows
- Natural language command interface for directing agent activities
- Dashboard monitoring showing real-time progress of agent tasks
- Persistent memory system allowing agents to remember preferences across sessions
- Integration with multiple AI coding tools such as Claude Code and Codex