@igormaka/pi-sandbox

A proper sandbox extension for pi, using the Anthropic Sandbox Runtime

Package details

← Back
extension

Install @igormaka/pi-sandbox from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:@igormaka/pi-sandbox
Package
@igormaka/pi-sandbox
Version
0.0.4
Published
May 4, 2026
Downloads
367/mo · 367/wk
Author
igormaka
License
unknown
Types
extension
Size
40.3 KB
Dependencies
4 dependencies · 0 peers
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

@igormaka/pi-sandbox

A proper sandbox extension for pi, using the Anthropic Sandbox Runtime.

Overrides these tools to enforce sandbox rules:

  • bash
  • read
  • write
  • edit

The agent can request escalation for any of them by passing:

  • unsandboxed: true

This triggers a user approval prompt before bypassing sandbox restrictions.

Pre-approved Commands

Bash commands can also be pre-approved via unsandboxedCommands in the sandbox config. Matching commands bypass the sandbox without prompting the user.

Allowed syntax:

  • "npm test" - exact match, allows only npm test
  • "git commit *" - prefix match, allows git commit -m "msg" and git commit --amend

Commands using shell operators like &&, |, or ; cannot be matched.