Piebald's tweakcc Cracks Claude Code Open With 2,000 Stars
A CLI tool that patches Claude Code's minified binary to unlock hidden features, custom system prompts, themes, toolsets, and AGENTS.md fallback support.
Takeaways
- tweakcc is an MIT-licensed CLI that patches Claude Code's minified binary to unlock customization.
- Edit all system prompts, tool descriptions, and subagent prompts via versioned markdown files.
- Create custom toolsets that hide unused tools from the model entirely, saving thousands of context tokens.
- Version 4.0 adds an npm API, sandboxed adhoc-patch scripts, and remote config loading from URLs.
- Adds AGENTS.md fallback, Opus Plan 1M mode, and ~50% faster MCP startup out of the box.
- Supports Windows, macOS, Linux, native binaries, npm, Homebrew, and Nix installations.
Claude Code ships as a minified JavaScript blob (or a Bun-packaged native binary) with a fixed UI, hardcoded system prompts, and a handful of themes. tweakcc, an open-source CLI from Piebald LLC, cracks it open and lets you rewrite almost everything: prompts, toolsets, spinner animations, table rendering, MCP startup behavior, and undocumented model aliases. It has crossed 2,000 GitHub stars and is now available on npm and Homebrew under the MIT license.
Patching a black box
tweakcc works by editing the shipped JavaScript directly. For npm installs, the cli.js file is patched in place. For native binaries, the embedded JS is extracted using node-lief, modified, and repacked (with ad-hoc signing on Apple Silicon).
Because updating Claude Code overwrites the binary, tweakcc keeps your changes in ~/.tweakcc/config.json and reapplies them with a single command:
npx tweakcc # interactive TUI
npx tweakcc --apply # reapply saved config after a CC update
It supports Windows, macOS, and Linux, including Nix/NixOS installations where it sees through makeBinaryWrapper shims to find the real Bun binary underneath.
What you can actually change
The feature list is broad enough that tweakcc functions as a shadow configuration layer for Claude Code. Highlights: