{"id":"martian-engineering-maniple","name":"maniple","homepage":null,"repo_url":"https://github.com/Martian-Engineering/maniple","category":"devtools","subcategories":[],"tags":["mcp","claude-code","codex","orchestration","tmux","iterm2","git-worktrees","multi-agent","local-automation"],"what_it_does":"maniple is an MCP server (plus Claude Code slash-command workflow) that orchestrates multiple subordinate Claude Code or OpenAI Codex sessions using local terminal backends (tmux or iTerm2). It can spawn worker sessions, manage them with git worktrees/branches for isolation, send messages, read logs, and monitor lifecycle/events; it also supports an HTTP service mode with streamable HTTP transport.","use_cases":["Running parallel Claude Code/Codex sessions for separate tasks (e.g., frontend vs backend)","Offloading implementation to background workers while keeping the coordinating agent’s context small","Monitoring and interacting with spawned workers (interrupt, take control, close)","Isolated experimentation using git worktrees per worker/issue","Adopting orphaned terminal sessions after MCP server restarts","Using HTTP mode for persistent MCP communication and worker polling"],"not_for":["Environments without tmux/iTerm2 support (since it relies on terminal backends)","Teams needing remote/cloud execution isolation (it appears focused on local terminal session orchestration)","Use cases requiring formal auth/tenancy controls via the API","Highly security-sensitive workflows where terminal/log artifacts must never be written to disk"],"best_when":"You want an agent-driven coordinator to launch and manage multiple local LLM coding sessions with visible terminal screens and per-worker git isolation.","avoid_when":"You cannot safely use local terminal automation (tmux/iTerm2) or cannot tolerate background sessions/worktrees and log files being created on the host.","alternatives":["Claude Code sub-agents (less monitorable, but simpler than terminal orchestration)","General-purpose orchestration frameworks that run agents as processes/containers (if you need stronger isolation)","Custom scripts wrapping tmux/iTerm2 to spawn editor/agent sessions"],"af_score":57.2,"security_score":28.5,"reliability_score":30.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:25:49.630204+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"No explicit authentication mechanism is described for the MCP tools or HTTP mode. Access control is likely implicit (local execution / whatever Claude Code provides)."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing model described; appears to be a developer tool/library."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":57.2,"security_score":28.5,"reliability_score":30.0,"mcp_server_quality":75.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":0.0,"tls_enforcement":60.0,"auth_strength":15.0,"scope_granularity":0.0,"dependency_hygiene":45.0,"secret_handling":30.0,"security_notes":"No authentication or authorization model is described for MCP/HTTP endpoints, so security appears to rely on local network/process boundaries. Terminal automation and log reading/writing imply sensitive data could end up in JSONL logs and worktrees unless users manage redaction/retention. HTTPS/TLS requirements for HTTP mode are not documented; score is therefore moderate-to-low. Dependency list includes iterm2 and mcp but no vulnerability/CVE posture is provided.","uptime_documented":0.0,"version_stability":35.0,"breaking_changes_history":40.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":"No stated idempotency guarantees for spawn/message/close operations. Worktree creation and session spawning could be non-idempotent depending on existing state.","pagination_style":"cursor_none","retry_guidance_documented":false,"known_agent_gotchas":["Operations that spawn workers/branches may be non-idempotent if repeated without checking existing sessions/worktrees.","Correct backend setup is required (tmux or iTerm2, plus iTerm2 Python API enabled).","In HTTP mode, ensure transport configuration is compatible with MCP client expectations (streamable-http).","Using worktrees creates persistent filesystem artifacts (.worktrees) and branches that may affect repo state if not cleaned up."]}}