pi-model-suitable-tools

Pi extension package that adapts tool names to the active model family.

Packages

Package details

extension

Install pi-model-suitable-tools from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-model-suitable-tools
Package
pi-model-suitable-tools
Version
0.3.0
Published
May 6, 2026
Downloads
418/mo · 418/wk
Author
monchi
License
Apache-2.0
Types
extension
Size
50.6 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

pi-model-suitable-tools

Pi Extension that switches model-facing tool shapes to match the active model family without changing prompts.

Motivation

Different model families are trained around different tool shapes. As Cursor notes in their article, giving each model the tool format it already expects can reduce unnecessary reasoning and mistakes. This extension applies that idea to Pi by exposing model-appropriate tool shapes while keeping the underlying behavior consistent.

Usage

Install this package into Pi:

pi install npm:pi-model-suitable-tool

For project-local installation, use Pi's local settings flag:

pi install -l npm:pi-model-suitable-tools

Behavior

  • Claude models get Claude Code style aliases: Read, Edit, Write, Bash, Grep, Glob, LS.
  • GPT/Codex models get Codex's default shell shape: shell_command, plus apply_patch.
  • Alias tools delegate to Pi built-in tools where possible.
  • apply_patch is implemented locally with Codex-style patch grammar.

Development

Install dependencies:

bun install

Run tests:

bun test

Run Pi with the extension temporarily during development:

pi -e ./