@pixxiti/pi-extension

Pi extension for connecting local Pi sessions to agents.pix.dev.

Packages

Package details

extension

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

npm report
$ pi install npm:@pixxiti/pi-extension
Package
@pixxiti/pi-extension
Version
0.0.1
Published
Jun 2, 2026
Downloads
not available
Author
brentkirkland
License
unknown
Types
extension
Size
46.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./src/pix-agents.ts"
  ]
}

Security note

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

README

@pixxiti/pi-extension

Pi package for connecting a local Pi coding-agent session to agents.pix.dev.

Install

pi install npm:@pixxiti/pi-extension

For local development from this repository:

pi install ./packages/pi-extension

Usage

Start Pi, then pair the session:

/pix:login

The extension defaults to https://agents.pix.dev. For local development, override the control plane:

PIX_AGENTS_URL=http://localhost:8787 pi

Optional environment variables:

  • PIX_AGENTS_URL — control-plane/API URL; defaults to https://agents.pix.dev
  • PIX_AGENTS_UI_URL — browser UI URL; defaults to PIX_AGENTS_URL
  • PIX_AGENTS_AGENT_ID — fixed agent id
  • PIX_AGENTS_NAME — local display name override
  • PIX_AGENTS_TOKEN — explicit pairing token

Commands

  • /pix:login — pair this Pi session with pix.dev
  • /pix:status — show connection status
  • /pix:attention <reason> — mark this session as needing attention
  • /pix:rename <name> — set a local display name
  • /pix:spawn [prompt] — start a new paired Pi session
  • /pix:disconnect — disconnect browser tunnel while keeping Pi running locally
  • /pix:unpair — disconnect and remove saved pairing credentials
  • /pix:shutdown — gracefully shut down Pi