@firstpick/pi-extension-tools

Interactive active-tool manager for Pi.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@firstpick/pi-extension-tools
Package
@firstpick/pi-extension-tools
Version
0.1.6
Published
Jun 8, 2026
Downloads
1,459/mo · 442/wk
Author
firstpick
License
MIT
Types
extension
Size
437.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "image": "https://unpkg.com/@firstpick/pi-extension-tools/images/tools_v0.1.2.png",
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-extension-tools

Interactive active-tool manager for Pi.

Interactive active-tool manager

Commands

  • /tools — open a TUI to enable/disable individual tools, then press Ctrl+S to save or q to cancel.
  • /tools list — print active/inactive tools grouped by source extension.
  • /tools enable <tool...> — enable one or more tools.
  • /tools disable <tool...> — disable one or more tools.
  • /tools reset — enable all currently available tools.

Saved tool choices are stored globally in ~/.pi/agent/tools.json (or $PI_CODING_AGENT_DIR/tools.json) with both active and inactive tool lists. On startup, only active tools are restored from that file. If the file is missing, the extension falls back to the current session branch state, then Pi's current active tools.

The current session branch still receives custom entries for branch history/debugging, but the global file is the cross-session source of truth.