About this mod

tama

A Claude Code mod: a classic Tamagotchi in a small LCD at the right end of the line above the prompt. It lives in real time, even while Claude Code is closed, and your work is what feeds it. Part of the Claude Code Arcade in claude-plugins.

What it does

• It hatches from an egg after three finished turns, then grows from baby to child to teen to adult over real days. The adult it becomes depends on how it was raised: hard working, a rascal, or well fed.
• Hunger drops every 20 minutes and joy every hour, in real time, also while Claude Code is closed. Every finished turn is a meal.
• Medium moments cheer it up a little, big moments a lot (hearts float up).
• A failed tool leaves a mess; five clean turns in a row tidy one away. Three messes, or an empty stomach, and it falls ill.
• Left hungry for twelve hours it packs its bags and leaves an egg behind. It never dies.
• At night (23:00 to 07:00 local time) it sleeps.
• Under the LCD: ♨ ▮▮▮▯ ♥ ▮▮▯▯ ✧ ▮▮▮▮ (food, joy, clean).
• /tama says how it is doing; /tama feed, play and clean are hand care, a few times a day; /tama hide puts it away and /tama show brings it back.

Moments

Every Arcade game spots the moments worth celebrating on its own, so each one installs alone with no dependency. Coding or not, a session has them.

| Size | Moments | |---|---| | Small | A finished turn, a file saved, every 10th tool call in a turn | | Medium | A commit, a push, a pull request opened, tests passing, any skill run, a subagent finished, a plan approved, an MCP tool that sends, creates, posts or publishes, a long document written, praise in your message | | Big | A merge, a release (gh release create, npm publish), a production deploy (vercel --prod, netlify deploy --prod, fly deploy and others), tests back to green after failing, a deliverable made (PDF, DOCX, XLSX, PPTX, images), a published page, a finished task list of three or more, a marathon turn (10 minutes, 30 tools, no errors), three subagents done in one turn, a 3, 7, 30 or 100 day streak, the 100th, 1,000th or 10,000th tool call |

A commit that says "nothing to commit" or a push that says "Everything up-to-date" counts for nothing. Tool calls inside subagents do not count; their finishing does.

Settings

All optional; every one is empty by default. Set them in /plugin (the plugin's settings) or in settings.json under pluginConfigs.

| Setting | What it is for | Example | |---|---|---| | big_skills | Skills whose run is a big moment (every other skill is medium) | release-notes, publish-report | | quiet_skills | Skills that celebrate nothing | commit | | big_commands | A regular expression of shell commands whose success is big | make ship | | medium_commands | A regular expression of shell commands whose success is medium | terraform apply | | praise_words | Extra words that count as praise, on top of the built-in list (thanks, great, perfect and a few in other languages) | nice one, cheers |

What it reads and does

• Reads: the name of each tool Claude runs and whether it failed; for shell commands, the command line and whether its output says nothing changed; for file writes, the file name and its line count; skill names; the words of your message (only to spot praise); subagent start and finish.
• Keeps: its own score and state in Claude Code's plugin store on your machine.
• Draws: one block at the right end of the line above the prompt, and an occasional notice.
• Hooks: skill.prompt only notes which skill ran, so a finished skill can count as a moment; it passes the skill's prompt on unchanged. command.run answers its own /tama command and no other.
• Privacy: see PRIVACY.md.
• Never: changes, blocks or delays a tool call or a message; sends anything anywhere (no network calls, no telemetry); reads file contents beyond counting lines of a file Claude writes.

Install

Needs Claude Code 2.1.287 or later (mods). Tested on 2.1.289.

/plugin marketplace add mutlumehmet/claude-plugins
/plugin install tama@mehmetmutlu

A mod runs inside Claude Code with your permissions. Read the code before you install any mod.

It draws in a terminal (including an editor's integrated terminal) and in the Code tab of the Desktop app; in the VS Code chat panel and claude -p it runs but draws nothing. Several Arcade games can be open at once, but the line above the prompt fills up: /<command> hide puts one away, /<command> show brings it back.

Known gaps

• Night is read from the computer's clock; there is no setting for other sleeping hours yet.
• Hand care is limited to six actions a day across feed, play and clean.

About

Made by Mehmet Mutlu, part of claude-plugins. More of his work at mehmetmutlu.dev.

License

MIT