@simular-ai/box-pi

box by Simular for the Pi coding agent: a cloud Linux computer with Chrome and a shell that Pi drives over MCP, while your own computer stays free. Sign in once in the browser; no key to paste.

Packages

Package details

extensionskill

Install @simular-ai/box-pi from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@simular-ai/box-pi
Package
@simular-ai/box-pi
Version
0.1.2
Published
Nov 16, 2026
Downloads
439/mo · 439/wk
Author
robin-simular
License
MIT
Types
extension, skill
Size
8 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./extensions/box.ts"
  ]
}

Security note

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

README

box for Pi

box gives the Pi coding agent a computer of its own: a cloud Linux desktop with Chrome and a shell that it drives over MCP, while your own computer stays free. Pi can browse sites (including ones behind a login), fill forms, use desktop apps and run commands there. You can watch the box live and take over at https://box.simular.ai/box.

Install

pi install npm:@simular-ai/box-pi

Then start pi, run /mcp login box inside the session and approve in the browser (the pi mcp shell commands don't load extensions, so they can't see box). New accounts get free credit. Ask Pi for anything that needs a computer, for example "open Hacker News in my box and summarize the top five posts".

What the package adds

  • An extension that registers box's hosted MCP server, https://mcp.box.simular.ai/mcp, with Pi's built-in MCP support. Needs Pi 0.99 or later; on an older Pi the extension prints a warning and does nothing. If you use pi-mcp-adapter instead, it connects the same server.
  • A box skill that tells Pi which box tool to use for what. Tools are named mcp__box__<tool>; shell, browser_navigate, browser_snapshot, screenshot and box_status are declared directly and the rest are found with tool_search.

Sign-in and what it touches

  • Sign-in is OAuth only. Pi stores the token in ~/.pi/agent/mcp-auth.json; the package reads no key, environment variable or local file.
  • Network: only https://mcp.box.simular.ai/mcp and the box sign-in page.
  • Commands and file edits run on the box, not on your machine.

Releasing

Bump version in pi/package.json, merge to main, then push a matching tag: git tag pi-v<X.Y.Z> && git push origin pi-v<X.Y.Z>. .github/workflows/release-pi.yml publishes it to npm with provenance.

Links

License

MIT. See LICENSE.