PokeDo is a CLI tool that gamifies your productivity. Every task you complete triggers a Pokemon encounter — the harder the task, the rarer the Pokemon. Track your mood, sleep, exercise, and more to unlock bonuses, then challenge other trainers to async PvP battles with a full ELO ranking system.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/tldrwtf/pokedo/llms.txt
Use this file to discover all available pages before exploring further.
Installation
Install PokeDo and set up your trainer profile in minutes
Quick Start
Add your first task, catch your first Pokemon, and explore the dashboard
Command Reference
Full reference for every command, subcommand, and flag
Multiplayer Battles
Challenge other trainers to async turn-based PvP battles
What you can do with PokeDo
PokeDo brings together task management, wellbeing tracking, and Pokemon collection mechanics in a single terminal application.Task Management
Create tasks with categories, difficulties, priorities, and due dates. Recurring tasks supported.
Pokemon Collection
Catch all 1025 Pokemon across 9 generations. View sprites, manage your team, and evolve your Pokemon.
Wellbeing Tracking
Log mood, sleep, exercise, hydration, and meditation. Each entry unlocks gameplay bonuses.
Progression System
Level up your trainer, earn badges, maintain streaks, and unlock rare items and Pokemon.
Interactive TUI
Launch a full-featured terminal dashboard with keyboard navigation and real-time updates.
PvP Battles
Async turn-based battles with Gen V+ damage formula, 18-type chart, and ELO ranking.
How it works
When you complete a task, PokeDo calculates an encounter chance based on difficulty and your current streak. If an encounter triggers, a Pokemon is selected from a rarity pool filtered by the task category’s type affinities. Your wellbeing logs from that day also influence which types appear and how easy the Pokemon is to catch.Install and initialize
Install PokeDo and run
pokedo init to create your trainer profile and download Pokemon data from PokeAPI.Add and complete tasks
Create tasks with
pokedo task add and complete them with pokedo task complete. Each completion has a ~70% base chance to trigger a Pokemon encounter.Catch and train Pokemon
Caught Pokemon gain EVs based on the task category, and level up as you complete more tasks. Evolve them with
pokedo pokemon evolve.Project structure
PokeDo stores all single-player data locally in~/.pokedo/ — no account or server required. Multiplayer battles and the leaderboard require a self-hosted PokeDo server.
| Component | Description |
|---|---|
~/.pokedo/pokedo.db | SQLite database with all your trainer data |
~/.pokedo/cache/ | Cached PokeAPI responses (populated on first init) |
~/.pokedo/cache/sprites/ | Downloaded Pokemon sprites for terminal preview |