Skip to main content

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 init sets up everything you need to start playing. It creates a local SQLite database at ~/.pokedo/pokedo.db, registers your trainer profile, and fetches Pokémon data from PokeAPI so encounters can begin. The download can take a few minutes on a first run for all 1025 Pokémon; use --quick or --gen to reduce the initial set. 
pokedo init [OPTIONS]

​
Flags

FlagShortDefaultDescription
--name-n"Trainer"Your trainer name
--quick-qfalseGen 1 only — loads 151 Pokémon instead of all 1025
--gen-g0Load a specific generation (1–9). 0 loads all generations
--concurrency—10Concurrent PokeAPI requests during init (min: 1, max: 50)

​
Generation ranges

GenerationRegionPokédex rangeCount
Gen 1Kanto#001–151151
Gen 2Johto#152–251100
Gen 3Hoenn#252–386135
Gen 4Sinnoh#387–493107
Gen 5Unova#494–649156
Gen 6Kalos#650–72172
Gen 7Alola#722–80988
Gen 8Galar#810–90596
Gen 9Paldea#906–1025120

​
Examples

# Fastest start: Gen 1 only, default trainer name
pokedo init --quick

# Set your trainer name with a full Pokédex download
pokedo init --name "Ash"

# Load only Johto (Gen 2) Pokémon
pokedo init --name "Ash" --gen 2

# Speed up the full download with more parallel requests
pokedo init --name "Ash" --concurrency 25

# Combine: named trainer, all generations, faster download
pokedo init --name "Misty" --concurrency 20

​
What init does

  1. Creates ~/.pokedo/ data directories.
  2. Creates (or finds an existing) trainer profile with the given --name.
  3. Sets that trainer as the default profile.
  4. Downloads and caches Pokédex entries for the selected generation range.
If a trainer with the same name already exists, init skips creation and re-uses the existing profile. You can safely re-run init with a different --gen to add more generations to the Pokédex. After initialization, get started with: 
pokedo task add "My first task" --difficulty easy
pokedo task complete 1
pokedo daily

Build docs developers (and LLMs) love

Get started for freeTalk to us