tweakcc is a lightweight, interactive CLI tool that lets you personalize your Claude Code experience.

With tweakcc, you can

• Customize all of Claude Code's system prompts
• 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
• Change the "CLAUDE CODE" banner text to your own text with your own figlet fonts
• Style the user messages in the chat history beyond the default plain gray text
• Remove the ASCII border from the input box

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

Additionally, we're working on features that will allow you to

• Pick from over 70+ spinning/thinking animations from cli-spinners
• Apply custom styling to the markdown elements in Claude's responses like code, bold, headers, etc
• Customize the shimmering effect on the thinking verb: disable it; change its speed, width, and colors

tweakcc supports Claude Code installed on Windows, macOS, and Linux, using npm, yarn, pnpm, bun, Homebrew, nvm, fnm, n, volta, nvs, and nodenv, or a custom location. (Note: it does not support native installations yet; see #29.)

Run without installation:

$ npx tweakcc

# Or use pnpm:
$ pnpm dlx tweakcc

tweakcc works by patching the Claude Code's minified cli.js file. 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 re-running the tool.

tweakcc stores its configuration files in one of the following locations, in order of priority:

1. ~/.tweakcc/ - If this directory already exists, it will always be used for backward compatibility; or if XDG_CONFIG_HOME is not set
2. $XDG_CONFIG_HOME/tweakcc - If ~/.tweakcc/ doesn't exist and $XDG_CONFIG_HOME is set

tweakcc is verified to work with Claude Code 2.0.25.

You can use tweakcc by running npx tweakcc, or npm install -g tweakcc and then tweakcc. Or build and run it locally:

git clone https://github.com/Piebald-AI/tweakcc.git
cd tweakcc
pnpm i
pnpm build
node dist/index.js

• ccstatusline - Highly customizable status line formatter for Claude Code CLI that displays model info, git branch, token usage, and other metrics in your terminal.
• claude-powerline - Vim-style powerline statusline for Claude Code with real-time usage tracking, git integration, and custom themes.
• CCometixLine - A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.
• cc-statuslines - Transform your Claude Code experience with a beautiful, informative statusline. One command. Three questions. Custom statusline.

tweakcc stores a backup of your Claude Code cli.js file for when you want to revert your customimzations, and also to reapply patches. Before it applies your customizations, it restores the original cli.js so that it can start from a clean slate. Sometimes things can get confused and your cli.js can be corrupted. In particular, you may run into a situation where you have a modified cli.js, and then tweakcc takes makes a backup of that modified cli.js. If you then try to reinstall Claude Code and apply your customizations, tweakcc will restore its backup of the old modified cli.js.

To break out of this loop you can install a different version of Claude Code, which will cause tweakcc to make a new backup of the new cli.js file. Or you can simply delete tweakcc's backup file (located at ~/.tweakcc/cli.backup.js or $XDG_CONFIG_HOME/tweakcc/cli.backup.js). If you do delete cli.backup.js, make sure you reinstall Claude Code before you run tweakcc again, or else if cli.js is the modified version it, will again get into the loop described above.

tweakcc tracks changes to your system prompt markdown files in its config directory (see Configuration directory above). It stores tracking data in systemPromptAppliedHashes.json and caches the hashes of the original system prompt text in systemPromptOriginalHashes.json. If you'd like to reset your system prompt markdown files to their original values, you can delete those JSON files and the system-prompts directory in your config directory. Running npx tweakcc will then generate new markdown files.

Run npx tweakcc first, and then navigate to the system-prompts directory in your config directory (see Configuration directory), which will have just been created, in your file browser. Each markdown file contains parts of prompts, such as the main system prompt, built-in tool descriptions, and various agent and utility prompts. Modify any of them, and then run tweakcc --apply or the tweakcc UI to apply your changes.

Run npx tweakcc, go to Themes, and modify existing themes or create a new one. Then go back to the main menu and choose Apply customizations to cli.js.

Some of the text Claude Code outputs has no coloring information at all, and unfortunately, that text is rendered using your terminal's default text foreground color and can't be customized.

Yes! You can use the FORCE_COLOR environment variable, a convention which many CLI tools including Claude Code respect. Set it to 0 to disable colors entirely in Claude Code.

Could you have have forgotten to actually set Claude Code's theme to your new theme? Run claude and then use /theme to switch to your new theme if so.

tweakcn, though similarly named, is unrelated to tweakcc or Claude Code. It's a tool for editing your shadcn/ui themes. Check it out!

MIT

Copyright © 2025 Piebald LLC.