Skip to main content
Back

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.

Repo, Full Access
  • 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: