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.

Tasks are the core gameplay driver in PokeDo. Every time you complete a task, the reward engine runs: you earn trainer XP, your lead Pokemon receives Effort Value (EV) training in a stat tied to the task’s category, and there’s a chance to encounter and catch a wild Pokemon. The task’s difficulty controls how much XP you earn, which rarity tier the encountered Pokemon is drawn from, and how many EVs are awarded. Choosing the right category and difficulty for each task is the primary way you shape your Pokemon collection and your team’s stats over time.

Task categories

Each of the six categories maps to a set of Pokemon types that receive a boosted encounter weight when you complete tasks in that category. The category also determines which stat your lead Pokemon trains.
CategoryBoosted encounter typesStat trained
workSteel, Electric, NormalSpecial Attack (Sp. Atk)
exerciseFighting, Fire, RockAttack
learningPsychic, Ghost, DarkSpecial Defense (Sp. Def)
personalNormal, Fairy, FlyingDefense
healthGrass, Water, PoisonHP
creativeFairy, Dragon, IceSpeed
Type affinities bias the encounter pool — they do not guarantee a specific type. If the biased pool is empty for the selected rarity, PokeDo falls back to the full rarity pool.

Task difficulties

Difficulty affects three things at once: the XP you receive, the rarity weights of any Pokemon encounter, and the EV yield awarded to your lead Pokemon.
DifficultyXP rewardEV yieldEncounter rate bonus
easy10 XP1 EV+0%
medium25 XP2 EVs+5%
hard50 XP4 EVs+10%
epic100 XP8 EVs+15%
The base encounter rate is 70%. Difficulty and your daily streak both add to this, capped at 95%.

Rarity weights by difficulty

RarityEasyMediumHardEpic
Common70%50%30%15%
Uncommon25%35%35%25%
Rare4%10%20%25%
Epic1%4%12%25%
Legendary0%1%3%10%

Commands

Add a task

pokedo task add "Complete project report" --category work --difficulty hard --due tomorrow
All flags are optional. Defaults are --category personal, --difficulty medium, and --priority medium.
# Minimal task
pokedo task add "Quick errand"

# Full options
pokedo task add "Learn Python decorators" \
  --category learning \
  --difficulty medium \
  --priority high \
  --due 2025-06-01 \
  --recur weekly \
  --desc "Work through chapters 4-6" \
  --tags "python,study"
Flags:
FlagShortDescription
--category-cwork, exercise, learning, personal, health, creative
--difficulty-deasy, medium, hard, epic
--priority-plow, medium, high, urgent
--duetoday, tomorrow, next week, or YYYY-MM-DD
--recur-rdaily, weekly, monthly, none
--descFree-text description
--tags-tComma-separated tag list

List tasks

# All pending tasks
pokedo task list

# Only tasks due today
pokedo task list --today

# This week's tasks
pokedo task list --week

# Filter by category
pokedo task list --category work

# Include completed tasks
pokedo task list --all

Complete a task

Completing a task triggers the full reward flow: XP, EV training, streak update, and a possible Pokemon encounter.
pokedo task complete 1
If a recurring task is completed and has a due date set, PokeDo automatically creates the next occurrence.

Edit a task

Any field can be updated after creation. Only the flags you pass are changed.
# Change priority
pokedo task edit 1 --priority urgent

# Change category and difficulty
pokedo task edit 3 --category exercise --difficulty hard

# Update due date
pokedo task edit 5 --due 2025-06-15

Delete a task

pokedo task delete 1
PokeDo prompts for confirmation. Pass --force to skip the prompt.
pokedo task delete 1 --force

Archive a task

Archiving hides a completed task from the default list without deleting it.
pokedo task archive 1

Recurrence

When you set --recur on a task that has a due date, completing it automatically schedules the next occurrence:
ValueNext occurrence
daily+1 day
weekly+7 days
monthly+30 days
Recurring tasks are best combined with a --due date. Without a due date, recurrence is stored but no next occurrence is created on completion.

Priority levels

Priority affects sort order in pokedo task list but does not change XP or encounter mechanics.

Low / Medium

Everyday tasks. Appear below high-priority items in the list.

High / Urgent

Surfaced first in task listings. Use urgent for anything blocking other work.

EV training in practice

Every time you complete a task, the lead Pokemon in your active team receives EVs in the stat corresponding to the task category. The amount depends on difficulty.
pokedo task add "Marathon training" --category exercise --difficulty epic
pokedo task complete 7
# Lead Pokemon gains 8 Attack EVs
EVs are capped at 252 per stat and 510 total across all stats. Once a Pokemon’s EV cap is reached, further completions in that category yield no EVs for that stat.
# View your lead Pokemon's current EVs and IVs
pokedo pokemon info 1
Example output:
Stats
 HP:  95  (  0 EV / 24 IV)
Atk:  55  (  0 EV / 18 IV)
Def:  40  (  0 EV / 31 IV)
SpA:  65  (252 EV / 15 IV)
SpD:  50  (  0 EV / 22 IV)
Spe:  90  (  0 EV / 28 IV)

Total EVs: 252/510
1

Identify the stat you want to train

Pick a category that maps to the stat. For example, use exercise tasks to train Attack.
2

Set difficulty to maximize yield

epic tasks give 8 EVs per completion. Aim for 252 EVs in a primary stat (32 epic completions).
3

Check progress with pokemon info

Run pokedo pokemon info <id> after a few completions to see the stat climbing.
4

Rotate to a second stat

Once the first stat hits 252, switch the task category to train your second priority stat. The 510 total cap leaves room for two fully-trained stats.

Build docs developers (and LLMs) love