dmos82/ninja-terminals
Multi-terminal Claude Code orchestrator — 1 orchestrator, 4 agents, ship faster
Platform-specific configuration:
{
"mcpServers": {
"ninja-terminals": {
"command": "npx",
"args": [
"-y",
"ninja-terminals"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
MCP server for multi-terminal Claude Code orchestration — spawn, manage, and coordinate 1-4+ parallel Claude Code instances with DAG task management and self-improvement.
npm install -g ninja-terminalsAdd to your .mcp.json:
{
"mcpServers": {
"ninjaterminal": {
"command": "npx",
"args": ["ninja-terminals-mcp"],
"env": {
"PORT": "3301",
"HTTP_PORT": "3300"
}
}
}
}Then use the /ninjaterminal skill in Claude Code:
/ninjaterminal --terminals 4 --cwd /path/to/projectninja-terminals --port 3300 --terminals 4 --cwd /path/to/projectOpen http://localhost:3300 for the web UI.
Ninja Terminals exposes 12 MCP tools for terminal orchestration:
| Tool | Description | |------|-------------| | spawn_terminal | Create a new Claude Code terminal instance | | list_terminals | Get all terminals with status, elapsed time, context % | | send_input | Send text/commands to a terminal | | get_terminal_status | Get detailed status for a specific terminal | | get_terminal_output | Read recent output lines from a terminal | | get_terminal_log | Get structured event log (DONE, BLOCKED, ERROR) | | assign_task | Assign a named task with scope to a terminal | | set_label | Update a terminal's display label | | kill_terminal | Stop and remove a terminal | | restart_terminal | Restart a terminal preserving its label | | get_session_info | Get session metadata (tier, limits, created) | | end_session | Finalize session and collect metrics |
mcp__ninjaterminal__spawn_terminal
label: "Build"
scope: ["src/", "lib/"]
cwd: "/Users/me/project"mcp__ninjaterminal__send_input
id: 1
text: "npm run build && npm test"mcp__ninjaterLoading reviews...