pi-open-plugin-shim
Run open-plugin-format plugins (https://open-plugins.com) on the Pi coding agent: a shim that maps open-plugin custody hooks, role agents, and commands onto Pi's extension API.
Package details
Install pi-open-plugin-shim from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-open-plugin-shim- Package
pi-open-plugin-shim- Version
0.1.2- Published
- Jul 13, 2026
- Downloads
- 669/mo · 232/wk
- Author
- dk
- License
- MIT
- Types
- extension
- Size
- 35.3 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./src/index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-open-plugin-shim
Run open-plugin-format plugins on the Pi coding agent.
Pi has no native support for the open-plugin format (.plugin/plugin.json, hooks/, agents/, commands/) used by open-plugins.com and the open-plugin spec. This shim bridges the gap: it loads an open-plugin and maps its parts onto Pi's extension API.
What it maps
| Open-plugin part | Pi mechanism |
|---|---|
hooks/ custody scripts (keyed off agent_type) |
Pi's tool_call blocking hook invokes the real hook script with the payload it expects |
agents/ role agents (context isolation) |
Pi sessions (newSession/fork), since Pi has no subagent primitive |
commands/ slash commands |
pi.registerCommand |
Because Pi provides no agent_type to a hook, the role identity is supplied by the host (the seat the shim is running as) rather than the runtime. That is a weaker identity guarantee than a runtime that isolates agents natively, and it is documented as such.
Status
Early. Built as part of the Estelle monorepo, where it is the layer that lets Pi run the Shipshape plugin.
License
MIT