TweakCC
Lightweight CLI tool for personalizing your Claude Code interface with custom themes and visual enhancements
Author: @Piebald-AI | GitHub Repo | 69 Stars|4 Forks|MIT License|Updated Aug 24, 2025
Overview
TweakCC transforms your Claude Code experience through comprehensive interface personalization. This lightweight CLI tool allows you to customize colors, animations, messaging, and styling to create a unique development environment that reflects your personal preferences.
Built with React and Ink, TweakCC provides an interactive terminal interface for creating custom themes, selecting from over 70 animations, and personalizing every aspect of your Claude Code CLI experience.
Features
- Custom Theme Creation - Interactive HSL/RGB color picker for complete interface customization
- 70+ Thinking Animations - Choose from a vast collection of spinning and processing animations
- Personalized Thinking Verbs - Custom messages displayed during Claude's processing states
- Markdown Element Styling - Customize the appearance of markdown elements in responses (Work in Progress)
- User Message Styling - Personalize how your messages appear in chat history
- Banner Text Customization - Change banner text with figlet font styling
- Cross-Platform Support - Compatible with Windows, macOS, and Linux
- Persistent Configuration - Settings saved in
~/.tweakcc/config.js
and persist across updates
Installation
Quick Start (Recommended)
npx tweakcc
Alternative Package Managers
# Using pnpm
pnpm dlx tweakcc
# Global installation (if preferred)
npm install -g tweakcc
tweakcc
Usage
Interactive Theme Creation
# Launch the customization interface
npx tweakcc
Follow the interactive prompts to:
- Select custom colors with visual picker
- Choose from 70+ animations for processing states
- Set personalized thinking verbs for custom messaging
- Configure markdown styling for response formatting (WIP feature)
Configuration Management
TweakCC works by patching Claude Code's cli.js
file and saves your preferences to ~/.tweakcc/config.js
. Your customizations include:
- Color Themes - HSL/RGB values for interface elements
- Animation Selection - Preferred thinking/processing animations
- Custom Messages - Personalized thinking verbs and banner text
- Style Overrides - Markdown and user message styling preferences
Environment Integration
- Your customizations automatically apply when running Claude Code
- Configurations persist across Claude Code updates
- Re-run tweakcc to modify or update your theme
- Compatible with Claude Code version 1.0.88
For detailed configuration options and advanced theming, see the official documentation.
Integration with Claude Code
TweakCC seamlessly integrates with your Claude Code installation, providing a personalized interface without affecting core functionality.
Enhanced Development Experience
- Visual customization that matches your development environment
- Personalized animations and messages for a unique CLI experience
- Persistent theming that survives Claude Code updates
- Interactive configuration that makes customization accessible to all users
TweakCC is developed by Piebald LLC as a community project. For technical support and updates, please refer to the official GitHub repository.