Airsc is free for everyone. If it helps you, support it with $2–$20.

Support
MCP serverSafeAgent workflow & memorySome setup

tweakcc

Piebald-AI · Piebald-AI/tweakcc

Customizes Claude Code with themes, custom system prompts, new toolsets, and session memory features.

Customize Claude Code's system prompts, create custom toolsets, input pattern highlighters, themes/thinking verbs/spinners, customize input box & user message styling, support AGENTS.md, unlock private/unreleased features, and much more. Supports both native/npm installs on all platforms.

2.5k stars209License: MITUpdated 4 days ago0 opens

Preview

▍

What you can do with it

  • Change the default 'thinking' verbs and UI colors of the Claude Code terminal.
  • Enable session memory so Claude remembers context between different coding sessions.
  • Apply custom system patches to unlock private features or modify tool behavior.

Safety check

Safe

No risky patterns found in the files we scanned.

Automated scan of the repo files. Always review code you run.

From the README

Check out Piebald

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

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.

ing...' to 'Claude is ing', changing the generating spinner style to a 50ms glow animation, applying the changes, running Claude, and using '/config' to switch to the new theme, and sending a message to see the new thinking verb format." width="800">

[!IMPORTANT] NEW in 4.0.0: tweakcc now has an API; use npm i tweakcc to 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, and tweakcc repack.

[!NOTE] NEW: tweakcc 4.0.0 also introduces several new patches:

With tweakcc, you can

  • Customize all of Claude Code's system prompts (NEW: also see all of Claude Code's system prompts)
  • Create custom toolsets that can be used in Claude Code with the new /toolset command
  • Highlight custom patterns while you type in the CC input box with custom colors and styling, like how ultrathink used to be rainbow-highlighted.
  • Manually name sessions in Claude Code with /title my chat name or /rename (see our blog post for implementation details)
  • Create custom themes with a graphical HSL/RGB color picker
  • Add custom thinking verbs that will show while Claude's working
  • Create custom thinking spinner animations with different speeds and phases
  • Style the user messages in the chat history beyond the default plain gray text
  • Remove the ASCII border from the input box
  • Expand thinking blocks by default, so that you don't need to use the transcript (Ctrl+O) to see them
  • Configure which Claude model each subagent (Plan, Explore, and general-purpose) uses
  • Switch between table formats - Claude Code default, Unicode (┌─┬─┐), ASCII/markdown (|---|), Unicode without top/bottom borders.

tweakcc also

  • Fixes a bug where the spinner animation is frozen if you have the CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC environment variable set (#46)
  • Allows you to change the context limit (default: 200k tokens) used with models from custom Anthropic-compatible APIs with a new environment variable, CLAUDE_CODE_CONTEXT_LIMIT
  • Adds the opusplan[1m] model alias, combining Opus for planning with Sonnet's 1M context for execution—reducing "context anxiety" (#108)
  • Adds a message to Claude Code's startup banner indicating that you're running the patched version of CC (configurable)
  • Speeds up Claude Code startup by ~50% with non-blocking MCP connections and configurable parallel connection batch size (#406)

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 Bun executable. Current Claude Code releases store the application as a graph of code-split JavaScript modules rather than one embedded cli.js; tweakcc discovers and updates the owning modules while preserving Bun's compiled graph layout. 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

View source on GitHub