@pontia/pi-client-plugin
Pi extension that connects coding-agent sessions to Pontia.
Package details
Install @pontia/pi-client-plugin from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@pontia/pi-client-plugin- Package
@pontia/pi-client-plugin- Version
0.1.0- Published
- Aug 17, 2026
- Downloads
- 169/mo · 20/wk
- Author
- cheny341
- License
- Apache-2.0
- Types
- extension
- Size
- 74.9 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
@pontia/pi-client-plugin
Connect Pi coding-agent sessions to Pontia.
Requirements
- Pontia running locally
- Pi CLI
- tmux
Install
pi install npm:@pontia/pi-client-plugin
Configure
Set the Pi command in $PONTIA_HOME/config.toml:
[runtime.pi]
tui_command = "pi"
Then launch Pi from Pontia, or run it in a tmux pane inside a workspace registered with Pontia. The extension loads automatically.
Troubleshooting
If a session does not appear in Pontia, verify that:
- Pontia is running
- the current workspace is registered with Pontia
- Pi is running inside tmux
Extension logs are available at:
${PONTIA_HOME:-$HOME/.pontia}/state/pi-hook.log
Follow the log while reproducing an issue:
tail -f "${PONTIA_HOME:-$HOME/.pontia}/state/pi-hook.log"