Below are answers to the questions users ask most often. If your question is not covered here, check the troubleshooting guide or open an issue on GitHub.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.
Can I play offline?
Can I play offline?
Yes. After the initial setup, all Pokemon data is cached locally in
~/.pokedo/cache/. You can complete tasks, catch Pokemon, track wellbeing, and use the TUI without an internet connection. An internet connection is only required on first run (to download Pokemon data from the PokeAPI) and for multiplayer features.How do I backup my progress?
How do I backup my progress?
Copy the entire
~/.pokedo/ directory to a safe location. The pokedo.db SQLite file inside it contains your trainer profile, task history, caught Pokemon, streaks, and all other game state. Restoring is as simple as copying it back.What happens if I miss a day?
What happens if I miss a day?
Your daily streak resets to 0. However, your best streak is preserved and displayed separately on your profile, so your longest run is never lost.
Can I catch legendary Pokemon?
Can I catch legendary Pokemon?
Yes. Legendary Pokemon can appear when you complete epic or hard tasks, which have a small encounter chance for legendary-tier Pokemon. Mythical Pokemon (Mew, Celebi, Arceus, and others) require a Legendary Ticket, which you earn by reaching long streaks — 100 consecutive days rewards a Master Ball, and extended streaks unlock ticket drops.
How does shiny hunting work?
How does shiny hunting work?
Every Pokemon encounter has a base shiny rate of 1%. Your daily streak adds +0.5% per day, up to a maximum of 10%. Keeping a long streak is the most effective way to increase your shiny odds.
| Streak length | Shiny chance |
|---|---|
| 0 days | 1% |
| 10 days | 6% |
| 18+ days | 10% (cap) |
Can I have multiple profiles?
Can I have multiple profiles?
Yes. Each trainer profile is stored in the same local SQLite database. To create a new profile, run
pokedo init --name "NewName". In the CLI, use pokedo profile set-default <name> to switch between profiles. In the TUI, press p to open the profile switcher.Does wellbeing tracking affect gameplay?
Does wellbeing tracking affect gameplay?
Yes, wellbeing actions have direct effects on Pokemon encounters:
- Sleep — good sleep quality improves catch rates.
- Hydration — reaching 8 glasses boosts Water-type encounter rates.
- Meditation — increases Psychic and Fairy-type encounter rates.
- Exercise — grants type-specific encounter bonuses.
- Gratitude journaling — provides friendship evolution bonuses.
How do I battle other players?
How do I battle other players?
PvP battles require a running PokeDo server. The general flow is:
- Start the server (
docker-compose up -doruvicorn pokedo.server:app --port 8000). - Register an account:
pokedo battle register -u myname -p mypass - Challenge another trainer:
pokedo battle challenge <opponent> -u myname -p mypass - The opponent accepts, both players submit teams, and then take turns submitting moves.
Do I need a server to play?
Do I need a server to play?
No. All single-player features — tasks, Pokemon catching, wellbeing tracking, the Pokedex, the TUI — work fully offline using a local SQLite database. The server is only required for PvP battles and the global leaderboard.
What battle formats are available?
What battle formats are available?
Three singles formats are supported:
Doubles and tournament formats are planned for a future release.
| Format | Team size | Active Pokemon |
|---|---|---|
singles_1v1 | 1 | 1 |
singles_3v3 | 3 | 1 |
singles_6v6 | 6 | 1 |
How does the ELO rating work?
How does the ELO rating work?
Every new account starts at 1000 ELO. The K-factor is 32, which controls how much each match shifts your rating. Winning against a higher-rated opponent earns more points than beating a lower-rated one, and the reverse is true for losses.Ranks are determined by your rating:
| Rating | Rank |
|---|---|
| Below 1100 | Youngster |
| … | … |
| 2100+ | Pokemon Master |
How do I evolve Pokemon?
How do I evolve Pokemon?
Pokemon level up as you complete tasks. Once a Pokemon meets its evolution requirements, you can trigger the evolution manually:Replace
<id> with the ID shown in pokedo pokemon box or pokedo team. Not all Pokemon can evolve — check your Pokedex for details.What is the difference between CLI and TUI?
What is the difference between CLI and TUI?
- CLI (Command Line Interface) — you type individual commands like
pokedo task addorpokedo pokemon box. Best for quick actions and scripting. - TUI (Terminal User Interface) — launched with
pokedo tui, this provides an interactive graphical experience with keyboard navigation, tabbed task views, real-time updates, and a visual dashboard. Best for day-to-day use.