nikhilagrima/claude-pet — explained in plain English
Analysis updated 2026-05-18
Get a visual and audio cue when Claude Code finishes a task or needs your attention while you work in another window.
Watch a GitHub repo for new commits, pull requests, or CI results without checking GitHub manually.
Get reminded to take eye, posture, and hydration breaks during long coding sessions.
| nikhilagrima/claude-pet | aim-uofa/reasonmatch | airbone42/360-data-athlete | |
|---|---|---|---|
| Stars | 12 | 12 | 12 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | hard | hard |
| Complexity | 2/5 | 5/5 | 4/5 |
| Audience | developer | researcher | general |
Figures from each repo's GitHub metadata at analysis time.
Optional GitHub personal access token needed to watch private repos or raise the rate limit.
Claude Pet is a small animated mascot that lives on your screen and reacts in real time to what Claude Code, the AI coding assistant, is doing. It floats in the corner of your screen and changes its expression and plays sounds depending on the state Claude is in, so you always know what is happening even if you have switched away to another window like Slack or a browser. The pet's eyes and sounds change for different events. Purple spinning eyes mean Claude is thinking, cyan scanning eyes mean it is reading files, blue sparkles mean it is writing code, and green arrows mean it is running a command. When a task finishes it plays three short dings, and if something fails it plays a low thud. If Claude needs your input or permission to continue, the pet plays two attention beeps so you notice even if you stepped away, which the README calls the killer feature since you no longer have to keep checking the terminal yourself. Beyond reacting to Claude, the pet has grown several other abilities. It can watch GitHub repositories you choose, either public or private with an access token, and notify you when things happen like new commits, pull requests being opened or merged, reviews, releases, or automated test runs passing or failing. It checks these repositories periodically rather than requiring a live connection, and only alerts you about things that happen after you started watching, so it will not flood you with old history. The pet also includes an ergonomics coach that reminds you to take breaks for your eyes, posture, and hydration at set intervals while you are actively working, pausing automatically when you are idle so it does not interrupt you unnecessarily. It shows an animated exercise for you to follow along with. This feature is explicitly described as wellness guidance rather than medical advice. Finally, the tool keeps a local memory of your projects, storing notes about decisions and conventions on your own computer, and automatically feeds relevant memory back to Claude Code at the start of new sessions so it has useful context without you retyping it. Claude Pet is free and open source and works on macOS, Windows, and Linux.
A desktop mascot that shows in real time what Claude Code is doing, watches your GitHub repos, coaches ergonomic breaks, and remembers project context.
Mainly Python. The stack also includes Python, SQLite.
MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.