@cr1ms0n/pi-subagent

Community fork of Luke Parke's pi-subagent with Jev model routing, local tool activation and verified Pi child capabilities

Packages

Package details

extensionskill

Install @cr1ms0n/pi-subagent from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@cr1ms0n/pi-subagent

Package: @cr1ms0n/pi-subagent
Version: 0.11.15
Published: Oct 7, 2026
Downloads: 4,188/mo · 1,705/wk
Author: cr1ms0n
License: MIT
Types: extension, skill
Size: 910.3 KB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./extensions/subagent.ts"
  ]
}

Security note

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

README

English | 简体中文

Pi Smart Subagents

Run isolated child agents in Pi, with Jev choosing the execution model and local policy controlling tool access.

An independent community fork of Luke Parke's @parke.dev/pi-subagent from LukasParke/pi-extensions. It retains named agents, parallel and background tasks, worktree isolation and usage accounting, and adds Jev model routing with child capability checks.

Installation

Requires Node.js 22.19.0 or newer and Pi. Do not enable this fork and @parke.dev/pi-subagent together: both register the same tools.

pi install npm:@cr1ms0n/pi-subagent

Before your first task, configure your TypeSafe API key and candidate models in ~/.pi/subagent.json. See the configuration example; keep credentials private and merge changes into any existing configuration.

Usage

Ask Pi, for example:

Use a read-only subagent to review this project's directory structure and summarize the main modules.

Jev selects the model, not individual tools. Local policy controls the permitted tool set, and startup checks which capabilities are available in the child. An explicitly requested tool must be available. See the tool policy and routing reference for details.

The default compact mode keeps ordinary delegation, parallel/background tasks, budgets and worktree management. For advanced request controls such as resume, synthesis and structured output, merge this field into ~/.pi/subagent.json, then reload or restart Pi after active tasks finish:

{ "toolMode": "full" }

See tool modes for the field split and upgrade behavior.

Open /subagents to inspect and manage tasks.
Open /subagent-cost to view usage.
See the usage reference for named agents, parallel tasks, background work, worktrees and structured results, or the TUI guide for keyboard controls.

Model execution and Jev selection may incur separate charges. Planning also invokes Jev; max_cost does not cap TypeSafe selector charges. See cost accounting.

Routing sends task text and candidate-model information to the selector. Set jevRouting.baseUrl only to a trusted endpoint, since it changes the recipient of routing data and the routing credential. See the security guide.

License

Thanks to Linux.do.