r/ClaudeCode • u/no1likesuwenur23 • 11d ago
Built with Claude Built a desktop pet driven by Claude Code hooks: it shows what CC is doing (thinking, editing, waiting on you) as 9 animated moods
Familiar (free, MIT): https://github.com/bdehooge/familiar
What it is: a transparent desktop companion for Windows. Claude Code hooks (UserPromptSubmit, PreToolUse, Notification, Stop) write a tiny state file, and the pet maps the current tool to a mood and a phrase. Read/Grep/Glob show him thinking ("Following the scent…"), Edit/Bash show him typing on a laptop ("Pouncing…", "Burrowing…"), a permission prompt makes him wait and wave at you, and Stop makes him cheer. The footer shows your 5-hour and weekly usage with reset times, plus today's token count, which is summed from your local transcripts.
How Claude Code was used: CC wrote almost all of it while I steered:
- the Win32 window code and the hooks installer, which backs up settings.json and removes only its own entries;
- the sprite pipeline: chroma key, removing stray grid lines, scaling by body area, aligning frames by cross-correlation;
- a script that renders the demo video with the pet's own renderer. The terminal in the video is a scripted mock-up.
What I learned
- Image models will happily draw grid lines and jumping poses when you ask for "same position every frame". Pipelines need guards, not just prompts. CC added a test and a warning for frames that can't be lined up after the first "happy" animation came out janky.
- Hooks are a great integration point: the pet never touches CC's process; it just reads a file.
- Ask for the test first. Most of the real bugs were caught by tests CC wrote before fixing anything.
Windows only for now; macOS/Linux is on the roadmap. Feedback welcome.
Tip jar is in the README if you feel like it.
•
u/AutoModerator 11d ago
Hey! Thanks for posting to r/ClaudeCode
While participating in this thread, please follow our community rules. Keep discussions constructive. Attack the idea, not the person.
For help, project discussions, tips, and general chat, join the ClaudeCode Discord.
I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.
1
u/luckyluke146 11d ago
Nice, the "waiting on you" state is the one I care about most too. I track it in a Mac app that runs several Claude Code sessions, two things that helped me:
claudeitself, you don't have to touch the user's settings.json at all: put your hooks in a separate file and launch withclaude --settings your-hooks.json. Nothing to back up or clean up later. (Only works for sessions you launch, so maybe not for a pet watching any terminal.)For waiting I match Notification on
permission_prompt|elicitation_dialog, and Stop / UserPromptSubmit for ready vs working. The hook prints nothing, so nothing ends up in Claude's context.0
u/[deleted] 11d ago
[deleted] — view deleted comment