codagatchi

A desktop Tamagotchi built with Tauri 2. It lives as a small floating widget and a system tray icon. Hatch ASCII creatures with a rarity system, keep them alive by feeding and playing, and build up a Codex of every species you've discovered.

Features

• Floating widget — 220×280px, borderless, always-on-top, draggable to any screen position
• Expanded panel — expands in-place to a tabbed view with Codex, Collection, and Settings
• ASCII creatures — 8 species across 4 rarity tiers, each with idle/happy/hungry art
• Stat system — hunger, happiness, and energy decay/regen each tick; feed and play to keep your creature healthy
• XP & milestones — earn XP over time and through interactions; milestones award new eggs
• Egg inventory — hatch eggs to discover new species (max 3 unhatched eggs at once)
• Codex — tracks every species: discovered entries show art and flavor text; undiscovered entries show a silhouette
• OS notifications — starvation warnings, death notices, and new egg alerts via native OS notification
• System tray — creature name and mood always visible; show/hide the widget from the tray menu
• Configurable tick interval — default 60s, adjustable in settings

Species

Hatch weights: Common 60% / Uncommon 25% / Rare 12% / Legendary 3%.

Game Mechanics

Per-tick stat changes:

Interactions:

Lifecycle events:

• Hunger ≤ 20 → starvation warning notification
• Hunger = 0 for 3 consecutive ticks → creature dies
• XP milestones (50 / 200 / 500 / …) → new egg added to inventory