Tamamon

Product Introduction

1. Definition: Tamamon is a native macOS desktop application (desktop pet / virtual pet) that functions as an interactive overlay, residing on the user's screen. It is a local-only, privacy-focused companion app that integrates with Claude Code activity.
2. Core Value Proposition: Tamamon exists to provide a gamified, ambient, and motivating companion for developers using Claude Code. Its core value is enhancing the coding experience through a low-friction, collectible virtual pet that grows with user activity, without compromising privacy or workflow.

Main Features

1. Local Claude Code Integration: Tamamon reads local Claude Code usage data directly from the user's Mac to fuel pet growth. It requires no API keys, accounts, or internet connection for this core function. The app monitors active coding sessions to trigger growth stages and can provide subtle visual nudges when a session is idle, waiting for user input.
2. Procedural Collection & Evolution System: The app features a gacha-style collection mechanic where users can obtain a new digital pet egg weekly. It includes 20 distinct species, each with unique visual designs, multiple life stages (Egg, Baby, Adult, Evolved), and behavioral quirks. A built-in "dex" tracks collected species.
3. Dynamic Environmental Reactivity: Tamamon's habitat and pet behavior are driven by real-time system data. It reacts to the local time of day (showing night/day cycles) and pulls local weather data to influence pet behavior (e.g., seeking shelter during rain). This creates a living desktop environment.
4. Interactive Pet Care Mechanics: Users can directly interact with their Tamamon through feeding (offering digital snacks), playing (with interactive elements like balls and bubbles), and decorating its habitat. These actions influence the pet's mood and happiness.
5. Persistent "The Room" Feature: This is a dedicated, cozy scene where all collected creatures can coexist and wander. It features its own day/night lighting cycle and serves as a living showcase for the user's collection.
6. Strict Local-Only & Privacy-Centric Architecture: The application is engineered to operate entirely offline after download. It reads only specific, local system metrics (Claude Code app activity, CPU/Memory usage for display) and never transmits any data to external servers. It requires no sign-in and creates no user account.

Problems Solved

1. Pain Point: The isolation and lack of tangible feedback in solo development workflows. Tamamon addresses developer loneliness and provides a visual, rewarding feedback loop for productive coding time.
2. Pain Point: The desire for ambient, non-intrusive desktop customization and life. It solves the need for a dynamic, interactive desktop element that doesn't hinder productivity or privacy.
3. Target Audience: Primarily developers and engineers who use Claude Code on macOS, specifically those on Apple Silicon machines running macOS 15 Sequoia or later. Secondary audiences include users nostalgic for virtual pet games (like Tamagotchi) and those seeking privacy-respecting desktop applications.
4. Use Cases: A developer wants a lightweight, fun way to track daily coding habits. A user seeks a decorative, living desktop pet that respects their privacy. A collector enjoys the weekly mechanic of discovering and raising new digital creatures.

Unique Advantages

1. Differentiation: Unlike cloud-based productivity trackers or gamified coding platforms, Tamamon is a purely local application with zero data collection. Unlike traditional desktop widgets or wallpapers, it is deeply interactive and tied to a specific user activity (coding).
2. Key Innovation: The seamless, permissionless integration with Claude Code activity. By reading local app usage without requiring authentication or an internet connection, it delivers a personalized experience with an unprecedented privacy guarantee. The combination of a collection system, environmental reactivity, and strict local operation is unique in the desktop app space.

Frequently Asked Questions (FAQ)

1. Is Tamamon safe and private to use? Yes, Tamamon is a highly secure and private macOS application. It is signed and notarized by Apple, and its core innovation is operating entirely locally—it reads only your Mac's local Claude Code activity and system stats for display, with absolutely no data uploads, tracking, or accounts required.
2. How does Tamamon work with Claude Code without an API key? Tamamon does not interact with Claude's servers or API. Instead, it monitors the local activity of the Claude Code application on your macOS system. This allows it to detect when you are actively coding to fuel your pet's growth, all without needing internet access, an account, or sensitive keys.
3. What happens to my Tamamon if I stop coding for a long time? Reflecting its inspiration from classic virtual pets, a neglected Tamamon will become unhappy and can eventually pass away. However, a well-raised adult will leave behind an egg, allowing a new pet to hatch and continue the cycle. This design encourages regular, but not constant, interaction.
4. What are the system requirements for Tamamon? Tamamon requires macOS 15 (Sequoia) or a later version of the operating system, and an Apple Silicon Mac (M-series chips). It is not compatible with Intel-based Macs or older versions of macOS.
5. How do I collect all 20 Tamamon species? New species are obtained through a weekly "gacha" or random egg roll. You receive one chance per week to obtain a new egg, encouraging long-term engagement. All discovered species are cataloged in the in-app "dex."