tweakcc is a CLI tool that upgrades your Claude Code experience. Customize its system prompts, add custom themes, create toolsets, and personalize the UI. From the team behind Piebald.
$ npx -y skills add Piebald-AI/tweakcc --agent claude-code
Repo: Piebald-AI/tweakcc
What's inside
We've released Piebald, the ultimate agentic AI developer experience.
Download it and try it out for free! https://piebald.ai/
Scroll down for tweakcc. :point_down:
tweakcc is a CLI tool that upgrades your Claude Code experience. Customize its system prompts, add custom themes, create toolsets, and personalize the UI. From the team behind Piebald.
[!IMPORTANT] NEW in 4.0.0: tweakcc now has an API; use
npm i tweakccto add to your project and see API!NEW in 4.0.0: You can now create custom patches via sandboxed scripts! Works with native installations. No need to fork tweakcc just to make a quick patch! See
tweakcc adhoc-patch.NEW in 4.0.0: You can also apply customizations from a remote URL to a config file. See Remote Config.
Also see
tweakcc --restore,tweakcc unpack, andtweakcc repack.
[!NOTE] NEW: tweakcc 4.0.0 also introduces several new patches:
- AGENTS.md support (demo video)
- :lock: unlock session memory (blog post) (thank you @odysseus0!)
/rememberskill- input pattern highlighters
- Opus plan 1M
- MCP startup optimization
- token count rounding
- statusline throttling/pacing
- auto-accept plan mode (thank you @irdbl!)
- dangerously bypassing permissions in sudo (thank you @brrock!)
- native installer warning suppression (thank you @brrock!).
With tweakcc, you can
/toolset commandultrathink used to be rainbow-highlighted./title my chat name or /rename (see our blog post for implementation details)┌─┬─┐), ASCII/markdown (|---|), Unicode without top/bottom borders.tweakcc also
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC environment variable set (#46)CLAUDE_CODE_CONTEXT_LIMITopusplan[1m] model alias, combining Opus for planning with Sonnet's 1M context for execution—reducing "context anxiety" (#108)tweakcc supports Claude Code installed on Windows, macOS, and Linux, both native/binary installations and those installed via npm, yarn, pnpm, bun, Homebrew/Linuxbrew, nvm, fnm, n, volta, nvs, nodenv, and Nix (including NixOS and nix-darwin), as well as custom locations.
tweakcc supports Claude Code's native installation, which is a large platform-specific native executable containing the same minified/compiled JavaScript code from npm, just packaged up in a Bun binary. We support patching the native binary on macOS, Windows, and Linux, including ad-hoc signing on Apple Silicon, via node-lief, our Node.js bindings for LIEF (Library to Instrument Executables).
While tweakcc has a large library of built-in patches, you can create custom patches by using tweakcc's API. If you don't want to create an npm package, you can use tweakcc adhoc-patch, which applies a custom Node.js script to your default Claude Code installation. Because adhoc-patch supports running scripts from an HTTP URL, you can even host a script on a GitHub Gist or pastebin for easy distribution.
Run without installation:
$ npx tweakcc
# Or use pnpm:
$ pnpm dlx tweakcc
unpack, repack, adhoc-patch)Read/model1→ prefixes from Read output/rate-limit-options from being injected/remember skilltweakcc works by patching Claude Code's minified cli.js file, reading customizations from ~/.tweakcc/config.json. For npm-based installations cli.js is modified directly, but for native installations it's extracted from the binary using node-lief, patched, and then the binary is repacked. When you update your Claude Code installation, your customizations will be overwritten, but they're remembered in your configuration file, so they can be reapplied by just running npx tweakcc --apply (you'll see a pre-apply summary and be asked to confirm; use --yes / -y to skip the prompt in scripts).
tweakcc is verified to work with Claude Code 2.1.162. In newer or earlier versions various patches might not work. However, if we have the system prompts for your version then system prompt patching is guaranteed to work with that version, even if it's significantly different from the verified CC version—the version number stated above is only relevant for the non-system-prompt patches. We get the latest system prompts within minutes of each new CC release, so unless you're using a CC version older than 2.0.14, your version is supported.
You can also create custom patches using tweakcc without having to fork it or open a PR. tweakcc adhoc-patch supports using custom scripts that work with native and npm-based installs and that automatically detect your Claude Code installation.
While tweakcc usually works by applying customizations from your local ~/.tweakcc/config.json, you can optionally pass the --config-url <http URL> flag when you use tweakcc --apply to have tweakcc fetch config from a remote URL and apply it to your local Claude Code installation. This is useful for testing someone else's config when shared via a Gist or pastebin, for example.
Example:
View @piebald-ai’s profileSplitrail is a fast, cross-platform, real-time token usage tracker and cost monitor for: Gemini CLI (and Qwen Code) Claude Code Codex CLI Cline / Roo Code / Zoo Code / Kilo Code (VS Code extension + CLI) GitHub Copilot (VS Code) GitHub Copilot CLI OpenCode Pi
@piebald-aiFAQ
tweakcc is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes patch-creation. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it