ninja-terminals

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-terminals

Add 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/project

ninja-terminals --port 3300 --terminals 4 --cwd /path/to/project

Open 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__ninjater