← all repositories
Piebald-AI/tweakcc

A crowbar for Claude Code's minified JavaScript innards

tweakcc patches Claude Code to expose system prompts, themes, and UI tweaks that the official client keeps locked away.

2.5k stars TypeScript Coding AssistantsLLMOps · Eval
tweakcc
Velocity · 7d
+2.6
★ / day
Trend
accelerating
star history

What it does

tweakcc is a CLI patcher for Claude Code. It modifies the tool’s minified cli.js—extracting and repacking the Bun native binary when necessary—to inject custom system prompts, themes, thinking verbs, spinner animations, and input highlighters. Your changes live in a local config file and get reapplied after official updates inevitably overwrite them.

The interesting bit

The project treats a closed-source terminal binary as a modding target. It uses node-lief to surgically extract JavaScript from Bun executables on macOS, Windows, and Linux, then patches and repacks them, effectively turning Claude Code into a user-tunable platform despite its monolithic packaging.

Key highlights

  • Rewrites Claude Code’s system prompts and adds custom toolsets accessible via /toolset
  • Themes, thinking verbs, spinners, and input-pattern highlighters for the terminal UI
  • Supports both npm-based and native Bun-binary installations across all major platforms
  • Includes an API and sandboxed adhoc-patch scripts for custom modifications without forking
  • Claims roughly 50% faster startup by making MCP connections non-blocking

Caveats

  • Verified only against Claude Code 2.1.62; newer or older versions may break non-system-prompt patches
  • Several newer features listed in the README still carry the note: “Missing documentation for above features coming soon”

Verdict

Worth a look if you live in Claude Code and want to tune its personality, visuals, or behavior. Skip it if you prefer your terminal tools unmodified and update-safe.

Frequently asked

What is Piebald-AI/tweakcc?
tweakcc patches Claude Code to expose system prompts, themes, and UI tweaks that the official client keeps locked away.
Is tweakcc open source?
Yes — Piebald-AI/tweakcc is open source, released under the MIT license.
What language is tweakcc written in?
Piebald-AI/tweakcc is primarily written in TypeScript.
How popular is tweakcc?
Piebald-AI/tweakcc has 2.5k stars on GitHub and is currently accelerating.
Where can I find tweakcc?
Piebald-AI/tweakcc is on GitHub at https://github.com/Piebald-AI/tweakcc.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.