Turnpack
Local MCP server that gives AI coding agents context-packing, test-gated multi-file edit with automatic rollback, and read-only batch scripting tools.
At a Glance
Local MCP server licensed under Apache License 2.0; free to use, change and redistribute, including in commercial products.
Engagement
Available On
Alternatives
Listed Nov 2026
About Turnpack
Turnpack is an open-source local MCP server by OnlyTerp that gives AI coding agents three tools to fold dependent round trips into fewer turns. It runs on the user's machine with no API keys, account, telemetry or network calls, and has zero runtime dependencies. The latest release listed is v0.2.0.
What It Is
Turnpack targets the trips that remain even when agents already batch independent reads: a search that must return before files are opened, and an edit that must land before tests run. It exposes pack, ship and batch over MCP stdio, so it works with Claude Code, Claude Desktop, Codex CLI, the ChatGPT desktop app, OMP, Grok Build, Cursor, Gemini CLI, OpenCode and other MCP clients.
The Three Tools
- pack runs a regex or literal search with surrounding code, reads several files whole, by line range or by single function, lists globs and optionally includes git status. Replies are size-capped and
.envand key files are redacted. - ship applies edits, patches, writes, moves and deletes across files, then runs the given verify commands. If verification fails, every file is restored byte-for-byte and the agent receives the failing output. Edits are validated before anything is written.
- batch runs a short read-only script over the repo with helpers such as
ctx.files,ctx.read,ctx.outline,ctx.grepandctx.gitStatus, in a separate process under Node's permission model.
Setup Path
It requires Node.js 22 or newer. npx turnpack demo runs all three tools against a throwaway repo, npx turnpack init detects installed AI apps and writes MCP entries after confirmation, backing up edited configs, and npx turnpack doctor checks each app's config and starts the server as that app would. Claude Desktop users can install a turnpack.mcpb bundle from each release.
Safety Model
The workspace is fixed by the server rather than the model. Secret files are redacted or refused, ship never writes .git contents or .turnpack.json, and an optional verify allowlist limits which commands run. Rollback uses snapshots and an on-disk journal that restores files after a hard kill. The README notes that verify commands run project code and that their side effects are not undone.
Measured Results
The README reports one rename task in Claude Code 2.1.280 with Claude Sonnet 5, median of three runs per arm: round trips went from 6 to 3, time from 23.4 s to 12.7 s and cost from $0.131 to $0.084. The author states this is a single small task and not a general benchmark.
Community Discussions
Be the first to start a conversation about Turnpack
Share your experience with Turnpack, ask questions, or help others learn from your insights.
Pricing
Open Source
Local MCP server licensed under Apache License 2.0; free to use, change and redistribute, including in commercial products.
- Apache License 2.0
- Runs entirely on your machine: no API keys, no account, no telemetry, no network calls
- Zero runtime dependencies
- Three tools: pack, ship, batch
- Automatic rollback when verify fails
Capabilities
Key Features
- pack: one-call regex search with context, multi-file reads, symbol extraction, globs and git status
- ship: multi-file edits followed by verify commands
- Automatic byte-exact rollback when verification fails
- Crash-recovery journal restores files after hard kill
- Pre-write validation of all edits with closest-match diagnostics
- batch: read-only sandboxed scripts over the repo
- Secret file redaction and workspace jail
- Optional verify command allowlist
- init and doctor commands to configure and check MCP clients
- Zero runtime dependencies, no network calls or API keys
