@monopi/monopi

One-click setup for pi-coding-agent — extensions, themes, skills, and agents. Like oh-my-zsh for pi.

Packages

Package details

package

Install @monopi/monopi from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@monopi/monopi

Package: @monopi/monopi
Version: 0.6.1
Published: Aug 28, 2026
Downloads: 278/mo · 28/wk
Author: ifiokjr
License: MIT
Types: package
Size: 10.4 KB
Dependencies: 1 dependency · 0 peers

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@monopi/monopi

All-in-one setup for pi-coding-agent: extensions, prompts, skills, themes, remote sharing, and dynamic subagent workflows.

Install

npx @monopi/monopi

This registers all monopi packages with pi in one command. Each package is installed separately so pi can load extensions with proper module resolution.

Options

npx @monopi/monopi                      # install latest versions (global)
npx @monopi/monopi --version 0.2.13     # pin to a specific version
npx @monopi/monopi --local              # install to project .pi/settings.json
npx @monopi/monopi --remove             # uninstall all monopi packages from pi

Start Here

Use this reading path depending on what you are trying to do:

I just want to use monopi → start in the root README.md, then jump into docs/feature-catalog.md for package-by-package detail
I want to try the latest local changes → run pnpm install, pnpm pi:local, restart pi, then exercise the feature in a real session
I want to contribute → read CONTRIBUTING.md, then the package README for the area you are changing
I want to understand ownership → use docs/feature-catalog.md to see which package owns which runtime feature, content pack, or library surface

Architecture at a glance

monopi repo
├── installer
│   └── @monopi/monopi
├── default runtime packages
│   ├── extensions
│   ├── background-tasks
│   ├── diagnostics
│   ├── subagents
│   └── web-remote
├── content packs
│   ├── themes
│   ├── skills
│   └── agents
├── opt-in extras
│   ├── adaptive-routing
│   ├── provider-catalog
│   ├── provider-cursor
│   ├── provider-ollama
│   ├── analytics-extension
│   ├── pi-remote-tailscale
│   ├── pi-bash-live-view
│   └── pi-pretty
└── contributor libraries
    ├── core
    ├── cli
    ├── shared-qna
    ├── web-client
    ├── web-server
    ├── db
    ├── analytics-db
    ├── analytics-dashboard
    └── docs

Packages

Package	Contents
`@monopi/extension-worktree`	Split session extension packages such as git-guard, custom-footer, tool-metadata, scheduler, usage-tracker, btw/qq, watchdog, external-editor, and worktree
`@monopi/background-tasks`	Reactive background shell tasks with `/bg`, `Ctrl+Shift+B`, log tails, and the `bg_task` tool
`@monopi/diagnostics`	Prompt completion timestamps, durations, per-turn timing, widget, and `/diagnostics`
`@monopi/subagents`	Subagent orchestration runtime (`subagent`, `subagent_status`, `/run`, `/chain`, `/parallel`, `/agents`)
`@monopi/web-remote`	`/remote` session sharing for browser-oriented remote access
`@monopi/skills`	19 skills including web-search, web-fetch, context7, debug-helper, shell syntax, quick-setup, and more
`@monopi/agents`	5 AGENTS.md templates for common roles

Optional packages that stay opt-in:

Opt-in packages that stay separate from the default installer bundle:

@monopi/adaptive-routing
@monopi/provider-catalog
@monopi/provider-cursor
@monopi/provider-ollama
@monopi/analytics-extension
@monopi/remote-tailscale
@monopi/bash-live-view
@monopi/pretty

Getting Started

npx @monopi/monopi
pi

For the full package-by-package feature inventory and the local development workflow, see the repo README and docs/feature-catalog.md in GitHub.