@include-tools/toolbox-pi-extension

pi extension for toolbox codemode sessions

Package details

← Back
extension

Install @include-tools/toolbox-pi-extension from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@include-tools/toolbox-pi-extension
Package
@include-tools/toolbox-pi-extension
Version
0.1.0-preview.0
Published
Apr 13, 2026
Downloads
79/mo · 2/wk
Author
mackross
License
MIT
Types
extension
Size
10.9 KB
Dependencies
1 dependency · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/toolbox.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@include-tools/toolbox-pi-extension

pi extension for toolbox codemode sessions.

Install

Preview:

pi install npm:@include-tools/toolbox-pi-extension@next

Use

Auto-load a toolset at startup:

pi --toolset ./toolbox.toolset.json -e npm:@include-tools/toolbox-pi-extension@next

Or load a toolset after startup:

/toolbox-load
/toolbox-load ./some-other.toolset.json

Unload the current toolbox session:

/toolbox-unload

Once loaded, the extension exposes super_tool. Invoke it with:

typescript_cell_source: calc.calc.add(2, 3)

Notes

  • super_tool is backed by toolbox codemode.
  • The extension keeps one composed codemode handle open per pi session.
  • --toolset and /toolbox-load both resolve paths relative to the current working directory.
  • sdkbridge does not currently expose compose-time effects, so this extension does not add an effects option.
  • TOOLBOX_BINARY_PATH can be used to point at an explicit toolbox binary for local development or debugging.

Publishing

First manual preview publish from a local machine:

npm run pack:dry-run
node ./scripts/publish-npm.mjs --channel preview

After the first successful publish, GitHub Actions can publish subsequent tagged releases with npm trusted publishing.