Tamamon 1.0 — a little friend who grows as you code 🐣

Tamamon 1.0 — a little friend who grows as you code 🐣

Since launch, Tamamon has grown up alongside all of you — and it's ready to call this 1.0.

A tiny pixel companion that lives on your desktop and grows from your real Claude Code sessions. No account, no cloud, nothing about your work ever leaves your Mac. Free, and always will be.

What 1.0 brings — a final polish pass driven by your feedback:

• A gentler presence — turn "always on top" off from the menu bar, collapse the card to a slim bar with ▾, or close it with ✕ when you need room to think. It folds away the moment you want it to.
• Never lost — the pet now finds its way home automatically when you dock/undock or switch displays.
• Easy to understand — a new "How Tamamon grows" guide you can reopen any time, clearer menu grouping, a growth bar that explains itself, and tidier text throughout.
• Bigger, cuter babies and a first-hatch moment that keeps its secret until it cracks open.
• Kinder to everyone — VoiceOver names, higher-contrast labels, and careful handling of your ~/.claude settings.

The heart of it, unchanged:

• Code with Claude → your egg hatches, grows, and evolves.
• 50 little Warmthfolk to meet and collect.
• It notices your hard days, celebrates your wins, and stays quietly out of the way.
• 100% local. Free. Yours.

Thank you for shaping every version of this. Here's to 1.0 — and to whatever we build next, together. 💛

Free for macOS · tamamons.com

Tamamon v0.9.8 — collapse & close the card

Tamamon v0.9.8 — fold it away when you need to focus

The card sits above your windows all the time, which is lovely — until it isn't. Now you're in control, right on the card:

• Collapse (▾) — tucks the card down to a slim bar with just your friend's name, so the pet keeps roaming but the panel gets out of the way. Expand (▸) any time.
• Close (✕) — hides the pet entirely. Bring it back whenever from the menu bar ("Show/Hide pet").
• Your collapsed/expanded choice is remembered across restarts.

Same cozy companion — now it folds away the moment you want room to think. 🐾

Tamamon v0.9.7 — bigger, cuter babies

Tamamon v0.9.7 — babies you can actually see 🐣

A hatchling was coming out barely bigger than its egg — too tiny to enjoy. Now the baby stage is a proper little size, so the moment it hatches actually feels like it grew.

• Baby stage is ~30% bigger — clearly larger than the egg, while still smaller than the adult, so you still see it grow up.
• Grounding and shadows adjust automatically; nothing else about your friend changes.

Thanks for the nudge — it's much cuter now. 🐾

Tamamon v0.9.6 — a tidier menu bar

Tamamon v0.9.6 — a tidier menu bar

The menu was getting long. It's now grouped so the things you reach for are up top and the rest is one hop away:

• Up top: show/hide, bring here, always-on-top, feed, session pets, mini-room, and your Tamamon list.
• Collection ▸ — dex, share card, export, import.
• Advanced ▸ — refresh, reset mini-room layout, session detection, connect real usage.

Nothing moved out of reach — just fewer items to scan at a glance. Checkboxes, translations, and shortcuts all work exactly as before.

Under the hood: every build now also constructs the full menu and pet UI inside the packaged app before shipping, so a "works in dev, breaks when packaged" glitch can't reach you. 🐾

Tamamon v0.9.5 — always-on-top toggle in the menu bar

Tamamon v0.9.5 — turn "always on top" off whenever you like

Some of you felt the pet sitting above every window all the time was a bit much. Fair. Now there's a quick switch for it right in the menu bar.

• Menu bar → "Always on top" — a simple checkbox. Off, and your friend politely slips behind other windows when you're focused elsewhere; on, and it stays visible like before.
• Takes effect instantly for your pet, the roaming session pets, and the mini-room.
• It was already tucked away in Settings — this just puts it one click away, and the two stay in sync.

Small comfort, your call. 🐾

Tamamon v0.9.4 — session hook fix (self-healing)

Tamamon v0.9.4 — the session pets actually work now 🐛→🐾

If you'd turned on Session detection and seen your Claude Code fill up with Contents/MacOS/python: No such file or directory errors on every stop — that was Tamamon's fault, and it's fixed.

The packaged app was registering its Claude Code hook with a path that doesn't exist inside the bundle, so Claude Code failed to run it every time. This release:

• Fixes the hook so it runs the app itself (a path that always exists) instead of a missing helper.
• Self-heals on launch — if you already have the broken hook, just open Tamamon once and it quietly repairs your ~/.claude/settings.json (your own settings and other hooks are left untouched).
• Preserves your setup carefully throughout — the fix was cross-checked to never drop a hook you added yourself.
• Hardened the release check so this class of "works in dev, breaks in the packaged app" bug can't slip through again.

If the errors already bothered you: open Tamamon once and they'll stop. Sorry for the noise. 🐾

Tamamon v0.9.3 — treating your setup with care

Tamamon v0.9.3 — treating your setup with care

A security pass over how Tamamon touches your machine. The headline: nothing about your work ever leaves your Mac — that was audited and confirmed. These fixes harden how carefully Tamamon handles your files:

• Your Claude Code settings are safe. When you toggle session detection, Tamamon edits ~/.claude/settings.json to add its hook. If that file couldn't be read cleanly (a stray comment, a BOM, mid-write by Claude Code), older builds could have overwritten it. Now Tamamon refuses to touch a file it can't fully read, writes atomically, and — if Claude Code edits the file at the same instant — re-reads and merges instead of clobbering. Your model, permissions, and env are never lost.
• Corrupt or shared collection files can't lock you out. A malformed decoration coordinate in an imported collection could crash the app on every launch. Now bad values are safely ignored.
• Polling settings are validated too, so a hand-edited config can't stall the pet.

Quietly more trustworthy with your machine. 🐾

Tamamon v0.9.2 — closing the gaps

Tamamon v0.9.2 — closing the gaps

A thorough pass over last week's changes turned up a few edge cases worth fixing before they reached anyone:

• The share card kept the egg's secret too. If you tried to make a share card while your friend was still an egg, its hidden name could slip onto the card (and the saved file). Now it gently waits — make your card once it hatches, when there's actually someone to show off.
• The mini-room "make leader" prompt no longer names an unhatched egg either — same surprise, kept.
• Your collection count now always matches between the share card and the dex.
• A menu-bar label could flip back to Korean for English/日本語/Español users after opening Settings — fixed, and guarded so it can't drift again.
• Hatching stays reliable even if you switch friends mid-celebration.
• A little lighter on your machine, too.

Small, steady, and a bit more careful each time. 🐾

Tamamon v0.9.1 — the egg keeps its secret 🥚

Tamamon v0.9.1 — the egg keeps its secret 🥚

Someone pointed out that a fresh egg was quietly spoiling its own surprise — the character was hidden inside the egg, but its name was shown right next to it, so you could already guess who was coming. That's fixed.

Now an unhatched egg stays a real mystery until the moment it cracks open:

• The "new egg" screen shows the rarity and a warm "who's inside stays a secret until it hatches" — no name, no species.
• The care label, tray list, and switcher all show a neutral "Egg" instead of the character's name while it's still an egg.
• The collection (Dex) no longer reveals an unhatched egg's species — a species unlocks the first time it actually hatches, then it's yours forever.
• The name (and screen-reader labels) stay hidden until hatch, so nothing leaks the surprise early.

When it finally hatches, you get the full reveal — who woke up, name them, share the moment. The way it was always meant to feel. 🐣

Thanks to the player who caught this.

Tamamon v0.9.0 — session pets that explain themselves

Tamamon v0.9.0 — session pets that explain themselves

A few of you asked what the roaming "session pets" were actually telling you — you'd see their names, but everything just said idle. Fair. That was the app being unclear, and it's fixed.

• Each wanderer is one of your Claude Code sessions — now it says so. Open session pets and a one-time note explains what you're looking at (once, never again).
• Honest badges — before, every pet read "idle" even when the app simply couldn't see the session's status. Now an unlit "Detection off" badge tells you the live states are hidden, and how to turn them on — distinct from a session that's genuinely idle.
• Hover to understand — every session pet now has a tooltip spelling out exactly what its state means (working, waiting for you, idle, or detection-off).
• Turn on Session detection in the tray and they light up: green while a session works, blue the moment one needs your reply.

Thank you John on Product Hunt for the nudge — this one's straight from your question. 🐾