@xynogen/pix-toolbox

Pi tool — gated tool toggle UI (/toolbox)

Packages

Package details

extension

Install @xynogen/pix-toolbox from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@xynogen/pix-toolbox
Package
@xynogen/pix-toolbox
Version
0.2.2
Published
Oct 22, 2026
Downloads
336/mo · 19/wk
Author
xynogen
License
MIT
Types
extension
Size
27.6 KB
Dependencies
2 dependencies · 2 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

pix-toolbox

Pi tool — gated tool toggle UI (/toolbox).

What it does

Registers a /toolbox slash command — a TUI fuzzy-search picker listing every registered tool (built-in, extension, MCP), split into Tools and MCP tabs. Each tool has one of three states:

State Mark Meaning
enabled ✓ Declared in the system prompt.
deferred ~ Not declared. tool_search loads it on demand. Only for tools with deferred exposure.
disabled # Not declared, and every call is blocked, also through tool_search or codemode.

Keys: tab switch tab · ↑↓ navigate · ctrl+e enable · ctrl+f defer · ctrl+d disable · space cycle · any other key types into the search.

  • Four tools (bash, edit, read, write) are protected and stay enabled.
  • State persists to ~/.pi/agent/pix.json under toolbox. Only changes from the default are saved: disabledTools (tools you disabled) and loadedTools (deferred tools you enabled). A newly installed tool keeps its default. A legacy enabledTools file is migrated on the next session start.
  • Headless subcommands: /toolbox enable|defer|disable <names>, /toolbox list [query].

Install

pi install npm:@xynogen/pix-toolbox

Standalone and opt-in. @xynogen/pix-core does not bundle it. It is a power-user tool-toggle UI.

Full distro

This package is part of Pix. The installer sets up Pi and the full distro. See Install for the notes for each OS.

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.sh | sh
# Windows
irm https://raw.githubusercontent.com/xynogen/pix-mono/main/scripts/install.ps1 | iex

License

MIT