Claude Code セッションがターミナルバックエンド(tmux または iTerm2)を介して他の Claude Code (または Codex) セッションのチームをスポーンし、管理できるようにする MCP サーバー。

紹介

[maniple は、MCP サーバーで、Claude Code が他の Claude Code または Codex セッションの「チーム」をオーケストできるようにするためのスラッシュコマンドのセットです。 ターミナルバックエンド(tmuxまたはiTerm2)を使用して、新しいターミナルセッションをスポーンし、ClaudeコードまたはCodexを実行します。

なぜ?

• 楽園主義: 多くの開発タスクは、論理的に並列化することができますが、限られた注意スパンを持つ人間にとっては並列性が困難であることを管理します。 一方、クラウデは、それで非常に効果的です。
• コンテキスト管理: ワーカーへの実装をオフロードすると、実装エージェントが新しいコンテキストウィンドウ(スマート)を生成し、マネージャのコンテクストを実装の詳細の自由にします。
• 背景作品: 時々、あなたはクロードコードは何かを研究するか、仕事のメインスレッドをブロックせずに質問に答えるつもりです。
• 可視性: [maniple]は、実際のクロードコードまたはコーデックスセッションをスポーン。 それらを見ることができ、それらを中断し、制御を取り、またはそれらを閉じます.

Maniple MCP Server

An MCP server that allows one Claude Code session to spawn and manage a team of other Claude Code (or Codex) sessions via terminal backends (tmux or iTerm2).

Introduction

maniple is an MCP server and a set of slash commands for allowing Claude Code to orchestrate a “team” of other Claude Code or Codex sessions. It uses terminal backends (tmux or iTerm2) to spawn new terminal sessions and run Claude Code or Codex within them.

Why?

• Parallelism: Many development tasks can be logically parallelized, but managing that parallelism is difficult for humans with limited attention spans. Claude, meanwhile, is very effective at it.
• Context management: Offloading implementation to a worker gives the implementing agent a fresh context window (smarter), and keeps the manager’s context free of implementation details.
• Background work: Sometimes you want to have Claude Code go research something or answer a question without blocking the main thread of work.
• Visibility: maniple spawns real Claude Code or Codex sessions. You can watch them, interrupt and take control, or close them out.

But, why not just use Claude Code sub-agents, you ask? They’re opaque – they go off and do things and you, the user, cannot effectively monitor their work, interject, or continue a conversation with them. Using a full Claude Code session obviates this problem.

Terminal Backends

maniple supports two terminal backends:

Backend selection order:

1. MANIPLE_TERMINAL_BACKEND environment variable (tmux or iterm)
2. Config file setting (terminal.backend)
3. Auto-detect: if TMUX env var is set, use tmux; otherwise iTerm2

Git Worktrees: Isolated Branches per Worker

A key feature of maniple is git worktree support. When spawning workers with use_worktree: true (the default), each worker gets:

• Its own working directory - A git worktree at {repo}/.worktrees/{name}/
• Its own branch - Automatically created from the current HEAD
• Shared repository history - All worktrees share the same .git database, so commits are immediately visible across workers

Worktree naming depends on how workers are spawned:

• With an issue ID: {repo}/.worktrees/{issue_id}-{badge}/
• Without: {repo}/.worktrees/{worker-name}-{uuid}-{badge}/

The .worktrees directory is automatically added to .gitignore.

Codex Support

Workers can run either Claude Code or OpenAI Codex. Set agent_type: "codex" in the worker config (or set the default in the config file) to spawn Codex workers instead of Claude Code workers.

Features

• Spawn Workers: Create Claude Code or Codex sessions with multi-pane layouts
• Terminal Backends: tmux (cross-platform) and iTerm2 (macOS)