pi-agentkernel
Route Pi coding agent commands through agentkernel microVM sandboxes
Package details
Install pi-agentkernel from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-agentkernel- Package
pi-agentkernel- Version
0.8.1- Published
- Feb 6, 2026
- Downloads
- 21/mo · 4/wk
- Author
- thrashr888
- License
- MIT
- Types
- extension
- Size
- 9.4 KB
- Dependencies
- 0 dependencies · 1 peer
Pi manifest JSON
{
"extensions": [
"./index.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
pi-agentkernel
Route Pi coding agent commands through agentkernel microVM sandboxes.
Install
# 1. Install and start agentkernel
brew tap thrashr888/agentkernel && brew install agentkernel
brew services start thrashr888/agentkernel/agentkernel
# 2. Install the extension
pi install npm:pi-agentkernel
What it does
This extension overrides Pi's built-in bash tool so every shell command runs in an isolated sandbox instead of on your machine.
- Session sandbox — A persistent sandbox is created when Pi starts and removed when it ends
- State persists — Installed packages and files carry over between commands
- Fallback — If agentkernel isn't running, commands run locally
Tools
| Tool | Description |
|---|---|
bash |
Built-in tool override — routes all shell commands through the sandbox |
sandbox_run |
One-shot command in a fresh sandbox (clean environment each time) |
Commands
| Command | Description |
|---|---|
/sandbox |
Show current sandbox status |
Configuration
| Variable | Default | Description |
|---|---|---|
AGENTKERNEL_BASE_URL |
http://localhost:18888 |
agentkernel API endpoint |
AGENTKERNEL_API_KEY |
- | Optional Bearer token for API auth |
Requirements
- agentkernel running locally or remotely
- Pi v0.49.0 or later
License
Apache-2.0