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 tui launches PokeDo’s interactive Terminal User Interface, built with Textual. The TUI gives you a full graphical experience inside your terminal: a live trainer dashboard, a task management screen with tabbed filtering, and keyboard-driven Pokémon encounter animations — all without leaving the terminal.
pokedo tui
No flags or arguments are accepted. The TUI reads your current default trainer profile from the local database on launch.

Dashboard screen

The dashboard is the entry point after launch. It shows your trainer profile, XP progress, active team, daily task summary, and streak status — all updating in real time.

Dashboard keybindings

KeyAction
qQuit the TUI and return to the shell
rRefresh the dashboard display
pSwitch between trainer profiles
tOpen the task management screen

Task management screen

Press t from the dashboard to open the task screen. Tasks are organized into four tabs:
TabContents
ActivePending tasks that are not completed and not archived
Due TodayTasks with a due date matching today
AllAll non-archived tasks including completed ones
ArchivedTasks that have been archived

Task screen keybindings

KeyAction
aOpen the add-task form
cComplete the selected task (triggers full Pokémon encounter flow)
eOpen the edit form for the selected task
dDelete the selected task (shows a confirmation dialog)
rRefresh all task lists
EscapeReturn to the dashboard
Completing a task in the TUI triggers the same reward flow as the CLI: XP is awarded, your streak updates, and a Pokémon encounter may occur with visual feedback in the terminal.

Profile switching

Press p on the dashboard to cycle through all trainer profiles stored in the local database. The TUI supports multiple profiles in a single session without restarting. Use pokedo profile set-default <name> if you want to persist a profile choice for future CLI invocations.
For a detailed guide to navigating the TUI and using all its features, see the TUI guide.

Build docs developers (and LLMs) love