shipper_switch_repo
shipper_switch_repo
Section titled “shipper_switch_repo”Switch this running MCP server to another already-existing local Shipper-ready git checkout for subsequent Shipper MCP operations. Runtime-only; does not clone, initialize, or persist configuration. Experimental — only registered when isMcpRepoSwitchEnabled() returns true. See Experimental feature flags for SHIPPER_EXPERIMENTAL_MCP_REPO_SWITCH enablement.
When to use
Section titled “When to use”Use this for modal runtime retargeting when the current MCP session needs subsequent Shipper operations to act on another already-existing local Shipper-ready checkout. It does not clone, initialize a repository, or persist configuration across server restarts.
Behavior hints
Section titled “Behavior hints”- idempotentHint: true — Retrying the same call is expected to be safe once the target state is reached.
- openWorldHint: true — The tool reaches GitHub or other external systems outside the MCP server.
Input schema
Section titled “Input schema”| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| path | string | yes | - | Path to an existing local git checkout to make active for subsequent Shipper MCP operations. |
Example call
Section titled “Example call”{ "path": "/absolute/path/to/other/repo"}Example result
Section titled “Example result”Switched active repository.repo: other/repopath: /absolute/path/to/other/repoError modes
Section titled “Error modes”- Invalid path: target repo path does not exist: /path, or the path is not a directory or is not readable/executable.
- Not a git repository: target repo is not a git repository: /path
- GitHub identity resolution failure: Could not determine repository. Run this command from inside a GitHub repository.
- Shipper preflight failure: .shipper directory not found, required labels are missing, or another Shipper preflight check failed.
- Commit failure: Could not switch active repository to /path. process.chdir failed: