Skip to main content
Glama
worktree-orbit-mcp

worktree-orbit-mcp

worktree-orbit-mcp

Worktree Orbit is a local MCP for developers who keep several Git worktrees alive at once. It answers whether a repository has parallel worktrees, whether they are clean, and whether detached, locked, or prunable worktrees need attention.

Tool

  • inspect_worktree_topology: returns aggregate worktree count, primary and linked counts, clean or dirty counts, detached state, lock state, prunable state, and a coarse topology hint.

It never returns paths, branch names, hashes, remotes, lock reasons, subjects, authors, or file contents.

Related MCP server: GitOps Safe MCP

Safety

  • Local Git commands only. No network access is used.

  • The selected repository must stay inside WORKTREE_ORBIT_ROOT.

  • Commands are read-only: the server does not add, remove, move, lock, unlock, reset, prune, or modify worktrees.

  • Worktree status checks are bounded and time limited.

  • Results are aggregate signals, not a replacement for inspecting a specific worktree before deleting it.

Run

npm install
npm run build
node dist/index.js

Available Tools

1 tool
inspect_worktree_topologyA

Summarize local Git worktree topology, clean or dirty state, detached worktrees, locks, and prunable entries without exposing paths, branch names, hashes, remotes, or content.

Inputs: cwd.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly described, making selection unambiguous.

    Naming Consistency5/5

    The tool name 'inspect_worktree_topology' follows a clear verb_noun pattern in snake_case, which is consistent and predictable. As a single tool, it sets a clear convention.

    Tool Count3/5

    The server has only one tool, which is on the low end of typical tool counts. While the narrow scope of inspection might justify a single tool, the server name suggests a broader worktree management capability, making the count feel slightly thin.

    Completeness2/5

    The tool provides a comprehensive inspection summary, but lacks any management operations (create, delete, prune, etc.) that the server name 'worktree-orbit' implies. This leaves significant gaps in the tool surface for full worktree lifecycle coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers