@xynogen/pix-toolbox

Pi tool — gated tool toggle UI (/pix tools)

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.9
Published
Nov 4, 2026
Downloads
1,333/mo · 632/wk
Author
xynogen
License
MIT
Types
extension
Size
27.3 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 (/pix tools).

What it does

Adds a Tools tab to /pix (/pix tools opens it directly) — 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/shift+tab switch tab · ↑↓ navigate · ←→/PgUp/PgDn inspect · ctrl+e enable · ctrl+f defer · ctrl+d disable · space cycle · esc close · any other key types into the search.

  • Rows are grouped: always-on tools first, then direct tools, then deferrable tools. Always-on tools (read, bash, edit, write, tool_search, codemode) are in every prompt. They are listed read-only and cannot be disabled or deferred. Direct tools can only be enabled or disabled.
  • 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.

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