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 is a CLI tool that gamifies your productivity. Every task you complete triggers a Pokemon encounter — the harder the task, the rarer the Pokemon. Track your mood, sleep, exercise, and more to unlock bonuses, then challenge other trainers to async PvP battles with a full ELO ranking system.

Installation

Install PokeDo and set up your trainer profile in minutes

Quick Start

Add your first task, catch your first Pokemon, and explore the dashboard

Command Reference

Full reference for every command, subcommand, and flag

Multiplayer Battles

Challenge other trainers to async turn-based PvP battles

What you can do with PokeDo

Task Management

Create tasks with categories, difficulties, priorities, and due dates. Recurring tasks supported.

Pokemon Collection

Catch all 1025 Pokemon across 9 generations. View sprites, manage your team, and evolve your Pokemon.

Wellbeing Tracking

Log mood, sleep, exercise, hydration, and meditation. Each entry unlocks gameplay bonuses.

Progression System

Level up your trainer, earn badges, maintain streaks, and unlock rare items and Pokemon.

Interactive TUI

Launch a full-featured terminal dashboard with keyboard navigation and real-time updates.

PvP Battles

Async turn-based battles with Gen V+ damage formula, 18-type chart, and ELO ranking.

How it works

1

Install and initialize

Install PokeDo and run pokedo init to create your trainer profile and download Pokemon data.
2

Add and complete tasks

Create tasks with pokedo task add and complete them with pokedo task complete. Each completion has a ~70% base chance to trigger a Pokemon encounter.
3

Catch and train Pokemon

Caught Pokemon gain EVs based on task category and level up as you complete more tasks. Evolve them with pokedo pokemon evolve.
4

Track your wellbeing

Log daily wellbeing entries to boost catch rates, unlock type bonuses, and extend your streak for better rewards.

Build docs developers (and LLMs) love