orchestragent-mcp

tzDel/orchestragent-mcp

3.1

If you are the rightful owner of orchestragent-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

An MCP (Model Context Protocol) server that manages isolated git worktrees for AI coding agents.

Tools
3
Resources
0
Prompts
0

orchestragent-mcp

An MCP (Model Context Protocol) server that manages isolated git worktrees for AI coding agents.

What it does

  • Creates .worktrees/session-<id> directories plus session-<id> branches on demand (base branch is main).
  • Persists session data in a SQLite database (.orchestragent-mcp.db by default). This ensures that session information survives server restarts.
  • Lists active sessions with worktree paths and diff stats versus the base branch.
  • Removes sessions with safety checks for uncommitted files and unpushed commits (override with force=true).
  • Speaks MCP over stdio so you can register it with any MCP-compatible client.

Architecture

See for detailed architecture documentation.

MCP Tools

  • Create Worktree: Create isolated git worktree and branch for an agent

    Example: "Create a worktree for session abc123"
    
  • Remove Session: Remove agent worktree and branch

    Example: "Remove all sessions" || "Remove session abc123"
    
  • List Sessions: Retrieve status, worktree path, and branch information

    Example: "List all sessions" || "List session abc123"
    

Configure with MCP Clients

Claude Code CLI

claude mcp add --transport stdio orchestragent-mcp -- "<path-to-binary>" -repo <path-to-repo>
claude mcp list

Codex CLI

codex mcp add orchestragent-mcp -- "<path-to-binary>" -repo <path-to-repo>
codex mcp list

Runtime flags

  • -repo: Path to the git repository (defaults to current working directory).
  • -db: Directory where the SQLite database should be created. Defaults to the current working directory; the database file is always named .orchestragent-mcp.db. Relative paths are resolved from the current working directory.

Project Status

Currently in development. See for vision and roadmap.