pi-extension-e2b
E2B cloud sandbox integration for pi — redirects all tool execution to a remote E2B sandbox
Package details
Install pi-extension-e2b from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-extension-e2b- Package
pi-extension-e2b- Version
1.0.0- Published
- Mar 22, 2026
- Downloads
- 42/mo · 13/wk
- Author
- edlsh
- License
- MIT
- Types
- extension
- Size
- 36.6 KB
- Dependencies
- 1 dependency · 2 peers
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-extension-e2b
E2B cloud sandbox integration for pi. Redirects all tool execution (bash, read, write, edit, ls, find, grep) to an E2B cloud sandbox, giving the agent a full Linux environment with internet access — completely isolated from your local machine.
Install
pi install npm:pi-extension-e2b
Setup
Set your E2B API key:
export E2B_API_KEY=your_key_here
Usage
pi --e2b # Create new sandbox (no file sync)
pi --e2b --e2b-sync # Create new sandbox and sync local files
pi --e2b --e2b-template custom # Use a custom E2B template
pi --e2b --e2b-sandbox <id> # Reconnect to an existing sandbox
Commands
| Command | Description |
|---|---|
/e2b |
Show sandbox status & info |
/e2b-upload |
Upload local file(s) to the sandbox |
/e2b-download |
Download file(s) from the sandbox |
/e2b-reconnect |
Connect to an existing sandbox by ID |
Keyboard Shortcut
Ctrl+Shift+E — Toggle E2B sandbox on/off mid-session.
LLM-Callable Tools
| Tool | Description |
|---|---|
e2b_port_url |
Get the public URL for a port running in the sandbox |
How It Works
When enabled, the extension replaces all 7 built-in pi tools (bash, read, write, edit, ls, find, grep) with E2B-backed implementations that execute in the remote sandbox. File sync uses git archive (or tar fallback) to upload your project. A keepalive timer extends the sandbox timeout automatically.
License
MIT