WinTokenMon v1.0.0 Production GA

🎉 WinTokenMon v1.0.0 — Production GA

First production-stable release! WinTokenMon turns your daily local AI coding token usage into a living Pokémon companion on Windows — 100% private, zero API keys, zero telemetry.

This release spans three feature milestones (v0.2.0, v0.3.0, v0.4.0) plus a full production-hardening pass.

---

✨ What's New Since v0.1.0-beta

🏆 Developer Achievements & Trophies (v0.2.0)

• 8 unlockable badges across Bronze → Platinum tiers: First Hatch, Night Owl Coder, Token Overclock, Multi-Tool Wizard, 100M Burn Club, Shiny Hunter, Senior Professor, Egg Hoarder
• Token & item rewards, toast notifications, and a new Trophy Cabinet dashboard tab

🍬 Interactive Feeding & Friendship (v0.3.0)

• Drop Rare Candies or Oran Berries onto your desktop — real gravity physics with damped bounces
• Your pet autonomously seeks, chases, and munches treats (with crunch SFX)
• New Friendship meter: petting & treats raise affection; ≥80% grants a +10% EXP boost
• Cinematic evolution ceremony modal

📟 Compact HUD Capsule + More Scanners (v0.4.0)

• New Ultra-Compact HUD mode: a 220×32px always-on-top pill showing live burn vs. limit (%), velocity (tokens/min), and hatch progress — switchable from the tray
• New token scanners: Aider, Windsurf (Cascade), Cline & Roo Code
• Per-provider toggles in Settings
• Start with Windows: registry-based autostart toggle

🚀 Production Hardening (v1.0.0)

• In-app auto-updater: once-a-day background check against GitHub Releases with a one-click Download & Install flow (SHA256-verified installer), Remind Me Later, and Skip This Version
• Performance: token scanning moved off the UI thread (background worker); non-blocking sprite downloads; lazy audio init; idle CPU usage significantly reduced
• Data safety: atomic savegame writes with automatic .bak backups, corrupt-state quarantine & recovery, loaded-value clamping
• Visibility: application log at %APPDATA%\WinTokenMon\logs\ with rotation; all critical errors recorded instead of swallowed
• Removed the developer debug console ahead of GA; dropped unused dependencies

---

📦 Downloads

File	Description
WinTokenMon-Setup-v1.0.0.exe	Recommended — interactive Inno Setup installer (per-user)
WinTokenMon-v1.0.0-Portable.exe	Single-file portable executable, no installation
*.sha256	SHA256 checksums for verifying your download

📥 Install via Winget (coming shortly)

winget install JustALearner101.WinTokenMon

Manifest submission to the microsoft/winget-pkgs catalog is in progress.

---

Full changelog: see CHANGELOG.md

---

🛡️ Windows SmartScreen Notice

When first running the installer or the portable .exe, Windows may show "Windows protected your PC". This is standard for unsigned apps from new publishers — these binaries are reproducible from this open-source repository and their SHA256 checksums are published above.

To proceed: click \More info\ → \Run anyway.

WinTokenMon v0.1.0-beta — Initial Windows Preview

🐾 WinTokenMon v0.1.0-beta — Turn AI Tokens into Pokémon Companions on Windows!

Welcome to the initial preview release of WinTokenMon, an interactive, gamified desktop pet and AI token monitor natively built for Windows! Inspired by PokeTokenBar (macOS).

---

✨ Key Features & Highlights

🤖 Multi-Provider Local Token Scanner

• 100% Offline & Private: Zero configuration and zero API keys. Reads only token count metadata from local file logs without ever inspecting your private code or prompts.
• Supported AI Tools:
  • 🟢 Claude Code (~/.claude/projects/**/*.jsonl)
  • 🔷 Cursor IDE (%APPDATA%/Cursor/.../state.vscdb)
  • 🟩 Codex CLI (~/.codex/sessions/**/rollout-*.jsonl)
  • 🟣 Antigravity CLI (~/.gemini/antigravity-cli/conversations/*.db)
  • 🐙 GitHub Copilot CLI (~/.copilot/session-store.db)
  • ⚡ Koma (~/.koma/sessions/*.json & ~/.koma/ledger/*.jsonl)
• Low-Resource Incremental Scanning: Ultra-fast O(Δ) tail scanner saves CPU cycles and prevents disk wear.

🐾 Living Transparent Desktop Pet

• Frameless Tkinter Window: Floats smoothly on your screen without black borders.
• Realistic Walking Physics: Step hop bounce, turnaround jumps, and footstep particles.
• Moods & States:
  • 💤 Nap / Sleep Mode: Snoozes with gentle sleep bubbles after 20 mins of idle time.
  • 🔥 Coding Burn Mode: Enters burst excitement when >500k tokens are generated in a short interval.
  • 🥚 Egg Wobble: Shakes eagerly when hatching progress reaches ≥90%.

🐣 Starter Selection & RPG Progression

• Gen 1–9 Starter Ceremony: Pick from 30 starter Pokémon with full confirmation dialog on first launch.
• Authentic Cries & Chiptunes: Plays authentic cries from PokéAPI and in-memory 8-bit level-up fanfares.
• Shiny Hunting (✨): 1/129 base shiny chance, boostable to 1/40 with the Shiny Charm!
• Dynamic Pokédex & Catch Log: Track all registered species and review detailed catch history with timestamps and natures.
• Shop & Inventory: Buy Rare Candies (+100M EXP), 20-personality Nature Mints, and high-tier eggs.

---

📦 Downloads & Installation

Asset	Description	Size
💿 WinTokenMon-Setup-v0.1.0-beta.exe	Recommended: Windows Setup Wizard (Desktop shortcut, Start on Boot)	~30.6 MB
🚀 WinTokenMon-v0.1.0-beta-Portable.exe	Zero-install standalone single executable (run directly from anywhere)	~28.9 MB

---

🎮 Quick Controls

• Move Pet: Click & drag sprite anywhere on screen.
• Interact / Pet: Single left click on sprite (plays cry + reaction bounce).
• Open Dashboard / Pokédex: Double-click sprite OR right-click sprite.
• System Tray: Right-click the Pokéball tray icon for quick preferences and controls.

---

🛡️ Disclaimer

WinTokenMon is an independent, non-commercial fan project created for developer productivity under Fair Use. Pokémon and Pokémon character names are trademarks of Nintendo, Creatures Inc., and GAME FREAK inc. No copyrighted game ROMs or commercial assets are distributed.

---

Feedback & Issues: If you encounter any bugs or want to suggest new AI assistant scanners, please open an issue on the Issues Tab!

Full Changelog: https://github.com/JustALearner101/WinTokenMon/commits/v0.1.0-beta