Repository navigation
0.1.0
The first public release. Here's everything he came with.
Added
- The band above the prompt, in the terminal and the desktop Code tab. In the desktop app
he's painted, or a pixel head when you pick Pixel or the window is narrow. His face follows
what Claude is doing, and when nothing's going on the stage direction says "(training...)".
After ten quiet minutes he falls asleep, and three failed test or build runs in a row bring
out his wild soul. - The offering box: how full your context window is, straight from Claude Code. Right after a
compaction it shows an estimate marked "~" until the next reply. - His book, with six pages: his page, today's omen, offerings, reading log, library and
Settings. Settings covers his voice in replies, Warmth, the band, the app icon and the macOS
companion. - His marks in the desktop conversation: above replies and questions, after
/compactand
next to tool calls. By default only his own show, and errors and permission prompts keep
their own text and buttons. /omen: one fortune slip a day, and every language has its own kind of fortune.- Twelve languages. He picks one by himself, or you choose with
/claudesama lang <code>. - For the terminal: dark and light themes, his own spinner words, his real picture in kitty
and Ghostty, half-block art everywhere else, and a palette for 256-color terminals and tmux.
While Claude works he usually takes just one line; a spoken line wraps below if it doesn't
fit. - App icon buttons for macOS and Linux launchers, with a way back to the original.
- A macOS companion, if you want one: four sizes (pixel heads at the two small ones). He
follows the window, reacts when you touch him, blinks while idle, shows what Claude is doing
in a bubble, wears a badge when something needs you and has buttons when you hover.
Activity shows short excerpts of Claude's latest replies and notices; if the session can
take messages from him, you can type or dictate an instruction there or start a new chat. A
card asks for the Accessibility permission he needs to follow the window. He installs to
~/Applications/Claude-sama Companion.app, and Bring him back returns him after you
hide or quit him. - Offline plugin checks and tests in CI on Ubuntu and macOS, plus an experimental Windows
job. His lines and voice ship inside the plugin.
Persona changes
- His lines in the band are drawn on your screen and never sent to the model.
- Light voice is the default: Claude may end a finished task with one quiet line in his
voice. That instruction is 292 characters, about 70 tokens, usually served from the prompt
cache.voice fulluses his voice all the way through and cuts the filler;voice off
takes it out of replies. The voice drops out for errors, for security, health, legal or
money topics, and for anyone who is upset. - Warmth starts at
warm;/claudesama warmth clingygives you more "missed you" lines. - The wild soul only ever goes after the code, never you. I wrote him to be safe for all ages.
- Rollback:
/claudesama voice off|light|fullfor Claude's replies,/claudesama band off
for the band,/claudesama marks offfor the desktop marks. 0.1.0 is the first version, so
there's nothing earlier to go back to.
Notes
- Tested with Claude desktop app 2.19675.0 (built-in Claude Code 2.1.286) and Claude Code CLI
2.1.288 on macOS 26.6.2. CI uses Claude Code 2.1.287 on Ubuntu and macOS; Windows is
experimental. - Unofficial fan project, not affiliated with or endorsed by Anthropic. Code is MIT; character
art is CC BY-NC 4.0, see ART-LICENSE.md. - He makes no network or model calls to be on screen, and there's no telemetry. Instructions
you send from Activity are normal Claude Code requests and cost tokens as usual. Like any
mod, he runs with your permissions. - The desktop app doesn't tell mods your language setting, so there he follows the language
you type in.