$ cat ~/map/monopi.md
monopi
One-command setup for Pi — extensions, themes, prompts, and skills, like oh-my-zsh for pi.
templates✓ Oct 16
Facts
- repository
- github.com/ifiokjr/monopi ↗
- GitHub Stars
- ★ 159
- Forks
- 21
- license
- MIT
- npm / mo
- —
- last push
- Oct 9, 2026
install
npx @monopi/monopi## TL;DR
One-command installer and configuration bundle for pi — npx @monopi/monopi sets up the default extensions (worktree, scheduler, background tasks, diagnostics), themes, and skills; like oh-my-zsh for pi.
## Key points
- $Installs the full default bundle in one command: runtime packages (extensions, background-tasks, diagnostics, subagents, web-remote) plus content packs (themes, skills, agents); --version pins a release, --local installs to the project's .pi/settings.json, and --remove uninstalls all monopi packages from pi.
- $On-by-default extensions include git-guard (auto git-stash checkpoints before agent changes), custom-footer (status bar with model, tokens, cost, and context-window percentage), diagnostics, tool-metadata, compact-header, external-editor, worktree (/worktree create, cleanup, list), scheduler (/remind, /loop cron, /schedule), btw (/qq side conversations), background-tasks (bg_task, /bg), and watchdog with a safe mode.
- $Six themes (monopi Dark, Cyberpunk, Nord, Catppuccin Mocha, Tokyo Night, Gruvbox Dark) and three maintained skill packs; three presets (Full Power, Clean, Subagents) covering providers Anthropic, OpenAI, Google Gemini, Groq, OpenRouter, xAI, and Mistral.
- $Opt-in packages that npx @monopi/monopi does not install: @monopi/adaptive-routing, @monopi/provider-catalog, @monopi/provider-cursor, @monopi/provider-ollama, and @monopi/analytics-extension — each added with pi install npm:<name>.
- $Treats pi 0.56.1 as the minimum supported runtime baseline for packages that integrate with the pi SDK; CI smoke-checks both that baseline and a pinned current runtime (0.64.0).
- $For terminals where emoji render poorly, plain-icons mode swaps them for ASCII fallbacks via OH_PI_PLAIN_ICONS=1, pi --plain-icons, or plainIcons: true in settings.json.
## FAQ
Q How do I remove monopi again?
npx @monopi/monopi --remove uninstalls all monopi packages from pi; --version 0.2.13 pins to a specific release instead of latest.
Q Which parts of monopi are not installed by default?
adaptive-routing, provider-catalog, provider-cursor, provider-ollama, and analytics-extension stay opt-in and ship as separate optional packages — install the ones you want with pi install npm:<name>.
## References
## Related entries
Last updated: Aug 31, 2026