# yohey-w/multi-agent-shogun

Samurai-inspired multi-agent system for Claude Code. Orchestrate parallel AI tasks via tmux with shogun → karo → ashigaru hierarchy.

Repository: https://github.com/yohey-w/multi-agent-shogun
Canonical: https://ross.abutalabs.com/products/multi-agent-shogun
Language: Shell
License: MIT
License Family: permissive
Topics: ai-agent, anthropic, automation, claude-code, llm, multi-agent, parallel-processing, samurai, shogun, tmux
Last push: 2026-08-06T08:08:18+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 85, longevity 15
- inputs: {"age_days": 220, "days_push": 27, "days_rel": 103, "gap_med": 0, "n_releases_24m": 24}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1419, forks 292 (observed 2026-08-28T04:04:40.301009+00:00)

## What it is
A samurai-themed multi-agent orchestration framework for Claude Code and other AI coding agents, built entirely in Shell/Bash. It coordinates parallel AI tasks through a shogun → karo → ashigaru hierarchy using tmux panes.

## Use cases
- run multiple AI coding agents in parallel
- orchestrate Claude Code tasks across tmux panes
- delegate coding tasks to a hierarchy of AI agents
- coordinate parallel AI agents with a manager and workers
- control AI agents from a phone with natural language commands
- manage a fleet of AI coding assistants without coordination overhead

## When to choose
- you want to run 10+ AI coding agents (Claude Code, Codex, Copilot, Kimi, OpenCode, Cursor) in parallel
- you prefer a lightweight shell-based orchestrator over heavyweight agent frameworks
- you work in tmux and want agents visible in separate panes
- you want a manager/worker hierarchy that delegates tasks automatically

## When to avoid
- you need a single-agent workflow or a judgment loop rather than parallel agents (see the successor kagemusha)
- you don't use tmux or bash 4+
- you want a GUI-based agent orchestration tool
- you're on Windows without WSL or a compatible shell environment

## Facets
- artifact type: framework
- maturity: active
- function: agent-framework, workflow-automation, developer-tools, cli
- domain: developer-tools
- platform: cli
- tags: claude-code, tmux, multi-agent, parallel-agents, samurai-metaphor, shell-script, ai-coding-agents, orchestration, ai-agents, automation, command-line, linux, macos, bash

## Member repositories
- yohey-w/multi-agent-shogun (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:40.301009+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:37:54.832968+00:00, confidence not recorded.
  - readme: https://github.com/yohey-w/multi-agent-shogun (fetched 2026-08-28T04:04:40.301009+00:00, sha 2853888acfb3)
- Data as of 2026-08-30T08:39:29.467469+00:00.