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.
PokeDo gives you access to all 1025 Pokemon across nine generations — from Bulbasaur in Kanto all the way through the newest arrivals in Paldea. Pokemon are earned by completing tasks: each completion has a chance to trigger a wild encounter, and whether you catch it depends on the Pokemon’s rarity, your trainer level, and the Pokeballs in your inventory. Once caught, a Pokemon stays in your box indefinitely, gains EVs whenever you complete tasks with it in your lead slot, and can evolve once it reaches the required level.
Generation coverage
| Generation | Region | Pokedex range | Pokemon count |
|---|
| Gen 1 | Kanto | #001–151 | 151 |
| Gen 2 | Johto | #152–251 | 100 |
| Gen 3 | Hoenn | #252–386 | 135 |
| Gen 4 | Sinnoh | #387–493 | 107 |
| Gen 5 | Unova | #494–649 | 156 |
| Gen 6 | Kalos | #650–721 | 72 |
| Gen 7 | Alola | #722–809 | 88 |
| Gen 8 | Galar | #810–905 | 96 |
| Gen 9 | Paldea | #906–1025 | 120 |
pokedo init --gen N to limit which generation is available for encounters, or pokedo init --quick to start with Gen 1 only.
Rarity tiers
Every Pokemon belongs to one of six rarity tiers. Rarity determines both the probability of a specific Pokemon appearing and your base catch rate.
| Rarity | Base catch rate | Examples |
|---|
| Common (60%) | 90% | Early-route Pokemon from every generation |
| Uncommon (25%) | 75% | Mid-evolution Pokemon, starters |
| Rare (10%) | 50% | Final evolutions, Paradox Pokemon |
| Epic (4%) | 30% | Pseudo-legendaries (Dragonite, Tyranitar, Garchomp), Ultra Beasts, final starter evolutions |
| Legendary (1%) | 15% | Articuno, Zapdos, Moltres, Mewtwo, Lugia, Ho-Oh, weather trio, creation trio, and more |
| Mythical (special) | 5% | Mew, Celebi, Jirachi, Arceus, and more — accessible only with special tickets |
How difficulty shifts rarity weights
| Rarity | Easy | Medium | Hard | Epic |
|---|
| Common | 70% | 50% | 30% | 15% |
| Uncommon | 25% | 35% | 35% | 25% |
| Rare | 4% | 10% | 20% | 25% |
| Epic | 1% | 4% | 12% | 25% |
| Legendary | 0% | 1% | 3% | 10% |
Mythical Pokemon do not appear through normal difficulty-weighted encounters. They require a Mythical Ticket, earned by reaching a 100-day streak.
Viewing your team and box
Your active team holds up to six Pokemon. The team is used in PvP battles, and the lead Pokemon (slot 1) receives EV training when you complete tasks.
# View your active team of up to 6
pokedo team
pokedo pokemon team
# View all Pokemon in your box (paginated, 20 per page)
pokedo pokemon box
pokedo pokemon box --page 2
pokedo pokemon box --limit 30
# View detailed info including EVs, IVs, and calculated stats
pokedo pokemon info 1
Pokedex
The Pokedex tracks every species you have seen or caught. Pokemon are marked as “seen” as soon as they appear in an encounter, even if they escape.
# Full Pokedex
pokedo pokedex
pokedo pokemon pokedex
# Show only caught species
pokedo pokemon pokedex --caught
# Filter by generation
pokedo pokemon pokedex --gen 3
# Paginate
pokedo pokemon pokedex --page 2
Managing your team
# Add a Pokemon to your active team (max 6)
pokedo pokemon set-active 5
# Remove a Pokemon from your active team
pokedo pokemon remove-active 5
# Give a Pokemon a nickname
pokedo pokemon nickname 1 "Sparky"
# Mark or unmark a Pokemon as a favorite
pokedo pokemon favorite 3
# Release a Pokemon back into the wild
pokedo pokemon release 10
Releasing a shiny Pokemon triggers an extra confirmation prompt. Pass --force to skip it: pokedo pokemon release 10 --force.
Evolution
Pokemon level up as you complete tasks — the lead Pokemon gains XP from every task completion. When a Pokemon reaches its evolution level, can_evolve is set to true. You then trigger the evolution manually.
# Evolve a Pokemon that is ready
pokedo pokemon evolve 3
Use pokedo pokemon info <id> to check a Pokemon’s current level and whether it can evolve before running the evolve command.
Sprite preview
PokeDo can render Pokemon sprites directly in your terminal.
# Preview by name (case-insensitive)
pokedo sprite pikachu
pokedo pokemon sprite pikachu
# Preview by Pokedex number
pokedo pokemon sprite 25
# Shiny variant
pokedo pokemon sprite charizard --shiny
pokedo pokemon sprite 6 --shiny
# Custom background hex color
pokedo sprite eevee --bg '#1e1e2e'
Full image rendering requires a terminal with inline image support, such as iTerm2 or Kitty. In unsupported terminals, PokeDo falls back to a text description. Sprites are cached locally in ~/.pokedo/cache/sprites/ after the first download.
The EV/IV stat system
Every Pokemon has two hidden layers of statistics that affect its calculated battle stats.
Individual Values (IVs)
IVs represent a Pokemon’s innate potential. They are assigned randomly at the moment of capture and never change.
- Range: 0–31 per stat
- Stats: HP, Attack, Defense, Special Attack, Special Defense, Speed
- A 31 IV is the maximum possible — a “perfect” IV in a stat
Effort Values (EVs)
EVs represent training accumulated through task completion. Each time you complete a task with a Pokemon in your lead slot, it gains EVs in the stat corresponding to the task’s category.
- Range: 0–252 per stat, 510 total across all stats
- Completing a
work task trains Special Attack
- Completing an
exercise task trains Attack
EV yield by difficulty:
| Difficulty | EVs gained |
|---|
| Easy | 1 |
| Medium | 2 |
| Hard | 4 |
| Epic | 8 |
| Task category | Stat trained |
|---|
| Work | Special Attack |
| Exercise | Attack |
| Learning | Special Defense |
| Health | HP |
| Personal | Defense |
| Creative | Speed |
HP = floor((2 × base + iv + floor(ev / 4)) × level / 100) + level + 10
Other = floor((2 × base + iv + floor(ev / 4)) × level / 100) + 5
base is the species base stat sourced from PokeAPI, iv is 0–31, ev is 0–252, and level is 1–100.
Shiny Pokemon
Shiny Pokemon are rare color variants. The base encounter rate for a shiny is 1% (1 in 100). Each day of your current task streak adds 0.5%, up to a maximum of 10%.
| Streak days | Shiny rate |
|---|
| 0 | 1.0% |
| 5 | 3.5% |
| 10 | 6.0% |
| 18+ | 10.0% (cap) |
* appears next to any entry where you have caught a shiny.
Catch rate modifiers
Your base catch rate depends on rarity, then several modifiers apply on top:
- Trainer level bonus: +2% per trainer level, up to +20%
- Ball bonus: Great Ball +10%, Ultra Ball +20%, Master Ball = guaranteed
- Sleep bonus: Logging 7–9 hours of sleep adds +10% to catch rate
The final rate is capped at 95%, except for Master Balls which always succeed.
PokeDo automatically uses the best ball available in your inventory for each encounter.