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 mechanic of PokeDo: completing a task triggers a Pokémon encounter, awards XP, and advances your trainer level. The task command group provides full CRUD operations plus an archive for keeping your list clean without permanently discarding completed work.
pokedo task <subcommand> [OPTIONS]
task add
Create a new task. The only required argument is the title; all other fields default to sensible values.
pokedo task add <title> [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|
--category | -c | personal | Task category (see valid values below) |
--difficulty | -d | medium | Difficulty level — affects XP and Pokémon rarity |
--priority | -p | medium | Priority level |
--due | — | null | Due date: YYYY-MM-DD, today, tomorrow, or next week |
--desc | — | null | Optional description / notes |
--tags | -t | null | Comma-separated tags (e.g. "urgent,work") |
--recur | -r | none | Recurrence pattern |
Valid category values
| Value | Boosted Pokémon types |
|---|
work | Steel, Electric, Normal |
exercise | Fighting, Fire, Rock |
learning | Psychic, Ghost, Dark |
personal | Normal, Fairy, Flying |
health | Grass, Water, Poison |
creative | Fairy, Dragon, Ice |
Valid difficulty values
| Value | XP reward | Encounter rarity |
|---|
easy | 10 XP | Common |
medium | 25 XP | Common + Uncommon |
hard | 50 XP | Higher rare/epic chance |
epic | 100 XP | Best legendary chance |
Valid priority values
low · medium · high · urgent
Valid recurrence values
none · daily · weekly · monthly
Examples
pokedo task add "Write quarterly report" --category work --difficulty hard --due tomorrow
pokedo task add "Morning run" --category exercise --difficulty medium --recur daily
pokedo task add "Read a chapter" --category learning --priority high --due 2026-06-01
pokedo task add "Weekend project" --tags "diy,home" --priority low
task list
Display tasks. With no flags, shows all pending (incomplete, non-archived) tasks.
pokedo task list [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|
--today | — | false | Show only tasks due today |
--week | — | false | Show tasks for the next 7 days |
--all | -a | false | Include completed tasks |
--category | -c | null | Filter by category |
Examples
pokedo task list
pokedo task list --today
pokedo task list --week
pokedo task list --all
pokedo task list --category work
pokedo task list --today --category exercise
task show
Display full details for a single task.
task complete
Mark a task as done. Completing a task triggers the full reward flow: XP is awarded, your streak updates, and a Pokémon encounter may occur.
pokedo task complete <id>
Example
task edit
Update one or more fields on an existing task. Any flag you omit is left unchanged.
pokedo task edit <id> [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|
--title | — | unchanged | New title |
--category | -c | unchanged | New category |
--difficulty | -d | unchanged | New difficulty |
--priority | -p | unchanged | New priority |
--due | — | unchanged | New due date |
--desc | — | unchanged | New description |
Examples
pokedo task edit 3 --priority urgent
pokedo task edit 3 --due tomorrow --difficulty hard
pokedo task edit 5 --title "Updated title" --category learning
task delete
Permanently remove a task. Prompts for confirmation unless --force is passed.
pokedo task delete <id> [OPTIONS]
Flags
| Flag | Short | Default | Description |
|---|
--force | -f | false | Skip the confirmation prompt |
Examples
pokedo task delete 4
pokedo task delete 4 --force
task archive
Move a completed task to the archive. Archived tasks are hidden from the default list view but can be shown with pokedo task list --all.
Example