Сервер MCP, который позволяет одной сессии Claude Code создавать и управлять командой других сессий Claude Code (или Codex) с помощью терминальных бэкэндов (tmux или iTerm2).

##Введение

maniple — это MCP-сервер и набор команд слэша, позволяющий Claude Code организовывать «команду» из других сессий Claude Code или Codex. Он использует терминальные бэкэнды (tmux или iTerm2) для создания новых сеансов терминала и запуска в них кода Клода или Кодекса.

###Почему?

Параллелизм: ** Многие задачи развития могут быть логически распараллелены, но управление этим параллелизмом трудно для людей с ограниченным вниманием. Клод, тем временем, очень эффективен в этом. Управление контекстом Отгрузка реализации работнику дает агенту-исполнителю новое окно контекста (умнее) и сохраняет контекст менеджера свободным от деталей реализации. ** Базовая работа: Иногда хочется, чтобы Клод Код что-то исследовал или отвечал на вопрос, не блокируя основной поток работы. ** Видимость: ** 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)