Pokéspaces

Your Pokémon team in Omarchy's workspace bar. Six configurable slots, shared across monitors, with each monitor's active Pokémon animated independently.

0.1.1 · 649 Pokémon · 27 Poké Balls · No shiny variants

Install

Requires Omarchy Quattro's Quickshell shell, Hyprland Lua dispatchers, Python 3.10+, and Git. Older Waybar setups are unsupported.

omarchy plugin add https://github.com/lilfrogdev/omarchy-pokespaces.git --yes
python3 ~/.config/omarchy/plugins/lilfrogdev.pokespaces/scripts/install.py

Run both commands as your normal user. Setup replaces the stock workspace indicator, backs up shell.json, preserves the rest of your bar, and installs the CLI in ~/.local/bin/. No sudo or Python packages needed. --enable alone would add another widget rather than replace the stock one.

Fallback: clone manually

Use this for a custom XDG_CONFIG_HOME or when native installation is unavailable. Clone anywhere:

git clone https://github.com/lilfrogdev/omarchy-pokespaces.git
cd omarchy-pokespaces
python3 scripts/install.py

Use

• Left-click to switch workspace; right-click to edit that slot.
• Active + occupied: animated Pokémon. Inactive + occupied: Poké Ball. Empty: white dot.
• Workspaces 7+ use ordinary numbers. Hover for workspace and Pokémon names.

Choose a slot, search Pokémon or Poké Balls, and select a result. Save applies the whole team to every monitor. Cancel, Escape, or clicking outside discards edits. Duplicates are allowed.

Poké Ball search

Agent / CLI

Ask your agent: “Put Umbreon in slot 3 with a Luxury Ball.” Or run:

pokespaces team show --json
pokespaces pokemon search umbreon --json
pokespaces balls list --json
pokespaces team set --slot 3 --pokemon umbreon --ball luxury-ball --json

Names or Pokédex IDs work; omitted fields stay unchanged. Export with pokespaces team show --json > team.json; import with pokespaces team apply --file team.json --json. See AGENTS.md for automation details. Keep ~/.local/bin on your PATH.

Update / restore / remove

For native installations:

omarchy plugin update lilfrogdev.pokespaces
python3 ~/.config/omarchy/plugins/lilfrogdev.pokespaces/scripts/install.py

For a manual checkout, run git pull --ff-only and python3 scripts/install.py from its directory.

Restore the stock indicator while keeping Pokéspaces installed:

python3 "${XDG_CONFIG_HOME:-$HOME/.config}/omarchy/plugins/lilfrogdev.pokespaces/scripts/install.py" --restore

Remove the installed plugin and its CLI:

python3 "${XDG_CONFIG_HOME:-$HOME/.config}/omarchy/plugins/lilfrogdev.pokespaces/scripts/install.py" --uninstall

Both preserve your team and cache. Removal also keeps shell backups and any separate source checkout.

Notes

• Only selected assets download; cached sprites work offline. Missing Pokémon fall back to their ball, then a dot. Reopen the picker to retry downloads.
• Team: ~/.config/omarchy-pokespaces/team.json. Cache: ~/.cache/omarchy-pokespaces/. Both respect their XDG variables.
• If an agent changes your team while the picker has unsaved edits, cancel and reopen before continuing.
• Stale UI after an update? Run omarchy restart shell.
• Verified on Omarchy 4.0.6-1 / Quickshell 0.3.2 across three monitors. Vertical bars remain visually unverified.

Credits

Code: MIT. Omarchy-derived code: Omarchy MIT notice.

Sprites: PokéAPI/sprites, pinned to 97a7832d307311c0e1c6ea9035308bf80cc94f81. English names come from PokéAPI. The upstream notice specifies CC0 for the repository and Pokémon Company copyright for image contents. Artwork in downloads and documentation retains its ownership; the code license does not cover Pokémon artwork or trademarks. Runtime sprites are not bundled.

Unofficial fan project, unaffiliated with The Pokémon Company, Nintendo, Game Freak, or Creatures.