https://github.com/kumamaki/Claude-Code-Personalities
Dynamic Kaomoji personalities for Claude Code's statusline that change based on what Claude is doing
https://github.com/kumamaki/Claude-Code-Personalities
Last synced: 9 days ago
JSON representation
Dynamic Kaomoji personalities for Claude Code's statusline that change based on what Claude is doing
- Host: GitHub
- URL: https://github.com/kumamaki/Claude-Code-Personalities
- Owner: kumamaki
- License: wtfpl
- Created: 2025-08-12T20:55:10.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-05-07T08:23:59.000Z (2 months ago)
- Last Synced: 2026-06-24T23:05:18.563Z (26 days ago)
- Language: Rust
- Size: 10.5 MB
- Stars: 7
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-code - claude-code-personalities - A delightfully different status line: 30+ kaomoji text-faces that react in real time to what Claude is doing — context-aware personas by file type, and a frustration-escalation system where mounting errors progress from `( ദ്ദി ˙ᗜ˙ )` toward a table-flip `(╯°□°)╯︵ ┻━┻`. Pure Rust with sub-2ms rendering, a single binary, hook-based activity tracking, and an interactive config TUI — the standout creative pick in a sea of metrics bars. (Status Lines)
README
# ૮ ․ ․ ྀིა Claude Code Personalities
> Dynamic text-face personalities for Claude Code's statusline
Give your Claude Code assistant a dynamic, context-aware statusline with 30+ text-face emoticons that change based on Claude's current activity.
Watch Claude transform from `ʕ•ᴥ•ʔ Code Wizard` when coding to `(┛ಠДಠ)┛彡┻━┻ Frustrated Developer` when encountering errors!
**Powered by Rust** - Lightning fast performance (~1ms statusline generation), zero external dependencies, and interactive configuration!
## Key Features
- **30+ Dynamic Personalities** - Context-aware text faces that reflect Claude's current mood and activity
- **Git Status Integration** - Real-time working tree status with file counts (`±5` for dirty, `✓` for clean)
- **Activity Tracking** - See what Claude is doing: editing, reading, executing, debugging, etc.
- **Nerd Font Icons** - Visual indicators for folders, git branches, activities, and models
- **Performance Optimized** - 2-second caching for git status, ~1ms statusline rendering
- **Interactive Configuration** - Easy-to-use TUI for customizing your statusline
- **Model Indicators** - Know which Claude model you're using (Opus, Sonnet, Haiku)
## Installation
### Quick Install (Interactive)
```bash
# Step 1: Install the CLI tool
curl -fsSL https://raw.githubusercontent.com/kumamaki/claude-code-personalities/main/install.sh | bash
# Step 2: Configure Claude Code (interactive prompts)
claude-code-personalities install
```
### Installation Options
- `--yes` or `-y`: Non-interactive installation with safe defaults
- `--interactive` or `-i`: Interactive installation (default)
- `NONINTERACTIVE=1`: Environment variable for non-interactive mode
## Updating
Claude Code Personalities includes automatic update checking:
```bash
# Check for updates and install if available
claude-code-personalities update
```
The statusline will show `[⬆ Update vX.X.X]` when a new version is available.
## Commands
```bash
# Installation
claude-code-personalities install # Interactive configuration (default)
claude-code-personalities install --yes # Non-interactive with safe defaults
claude-code-personalities install -y # Short flag for non-interactive
# Configuration
claude-code-personalities config # Interactive configuration menu
# Management
claude-code-personalities status # Check installation status
claude-code-personalities update # Check for updates and install if available
claude-code-personalities uninstall # Remove personalities (restart Claude required)
claude-code-personalities help # Show help with all options
```
## Requirements
- Claude Code v1.0.60+
- Nerd Fonts for icons (`brew install --cask font-hack-nerd-font`)
## Platform Support
### Supported Platforms
- **macOS** (Intel & Apple Silicon)
- **Linux** (x86_64 & ARM64)
### Windows Not Supported
**Windows is not currently supported** due to me not caring about development on windows:
- Uses Unix-style paths (`~/.local/bin`, `/tmp`)
- Relies on Unix file permissions
- Hook system designed for Unix shells
**Windows users:** Consider using WSL2 (Windows Subsystem for Linux) which provides full compatibility.
## Configuration
Customize what appears in your statusline using the interactive configuration:
```bash
claude-code-personalities config
```
This opens a multi-select menu where you can toggle. When you open the configuration menu, your current settings are pre-selected with checkboxes, making it easy to see what's currently enabled versus disabled:
- **Show Personality** - Text-face emoticons (ʕ•ᴥ•ʔ, (╯°□°)╯, etc.)
- **Show Activity** - Current activity (editing, coding, debugging, etc.)
- **Show Activity Context** - Current file or command being executed
- **Show Git Branch** - Current git branch name
- **Show Git Status** - Working tree status with file count (`±5` dirty, `✓` clean)
- **Show Current Directory** - Working directory path
- **Show Model Indicator** - Claude model (Opus, Sonnet, Haiku)
- **Use Icons** - Nerd Font icons for visual appeal
- **Use Colors** - ANSI color formatting
- **Show Separators** - Dot separators between elements
- **Compact Mode** - Reduced spacing for tighter display
- **Debug Info** - Show error counts and session info
Settings are saved to `~/.claude/personalities_config.json` and take effect immediately.
## Building from Source
For developers:
```bash
git clone https://github.com/kumamaki/claude-code-personalities
cd claude-code-personalities
cargo build --release
# Binary will be at target/release/claude-code-personalities
```
## License
WTFPL - Do what you want with it.