@lincieme/pi-mini-agent

Streaming subagent tool for Pi with read/work modes and token/cache usage reporting

Packages

Package details

extension

Install @lincieme/pi-mini-agent from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@lincieme/pi-mini-agent
Package
@lincieme/pi-mini-agent
Version
0.1.3
Published
Sep 14, 2026
Downloads
202/mo · 157/wk
Author
lincieme
License
MIT
Types
extension
Size
28.4 KB
Dependencies
0 dependencies · 4 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-mini-agent

A minimal subagent extension for Pi.

Features

  • agent tool with explorer, reviewer, and work modes
  • isolated child Pi process
  • inherits the parent model and lowers the parent's thinking level per profile (explorer −2, reviewer −1, work −1)
  • streams assistant and tool activity
  • reports input/output/cache tokens and cost
  • abort propagation
  • disposable sessions
  • configured extensions remain enabled in child processes
  • per-profile tool allowlists, including extension tools

Install

pi install npm:@lincie/pi-mini-agent

Usage

// quick read-only discovery
agent { mode: "explorer", prompt: "Find the authentication flow" }
// deep read-only review
agent { mode: "reviewer", prompt: "Review the authentication flow for risks" }
// work mode can edit
agent { mode: "work", prompt: "Refactor X and add tests", cwd: "/path" }

The profile tool lists are defined near the top of index.ts. Add an extension tool name to the specific profile(s) that should be allowed to use it. Child processes load configured extensions, so extension overrides of built-in names such as read and grep are used when those names are allowlisted. The agent tool is explicitly excluded to avoid recursive delegation.

Requirements

  • Node >=20
  • pi-coding-agent

License

MIT