@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.13.0
Published: Oct 17, 2026
Downloads: 4,456/mo · 851/wk
Author: cr1ms0n
License: MIT
Types: extension, skill
Size: 1 MB
Dependencies: 0 dependencies · 4 peers

Pi manifest JSON

{
  "skills": [
    "./skills"
  ],
  "extensions": [
    "./extensions/subagent.ts",
    "./extensions/task.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 and managed shell commands in Pi. Jev chooses subagent models; ordinary command tasks use your existing bash tool without model selection.

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 subagent 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.

The separate task tool needs Pi 1.2.0+ with a callable bash, not Jev configuration. Both extension entries ship in the package and can also be loaded independently.

Command tasks

Use task for a non-interactive build, command or script in the current directory:

{ "command": "npm run build" }

It waits up to 30 seconds by default, then returns the same task ID while that one command continues in the background. Set "background": true to return a receipt immediately, or use timeout_ms to change this call's wait. Native bash.timeout keeps its existing hard-stop meaning.

Keep the full task ID for list, status, output, wait and cancel. Logs remain under the configured session directory; output reads use repeatable UTF-8 byte cursors. Background completion notifies the owning session unless notifications are disabled. Exit, reload and branch/session replacement request cancellation; tasks are not persistent daemons. See command task examples and limits.

Subagent 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.

Subagent timeout_ms is a reminder, not a stop limit. At the threshold, a foreground call returns the run ID and the same work continues in the background. Use status, wait, steer or cancel to decide what happens next. Existing time settings now have this advisory meaning; turn/cost budgets and independent fault checks remain. See budgets and retries.

Every child launched by this package automatically receives a package-owned mandatory rule: it must not run tests or test commands, and it must not create or modify test code. Delegated children implement changes and review statically and report untested work; executable testing belongs only to the TOP-LEVEL main agent, never to a delegated child, so an intermediate delegating child owns no tests either. Logs and backups remain allowed within the existing task scope and tool permissions. This is a prompt-level instruction, not a sandbox, and it applies to new launches after the updated package is loaded, not to already-running children or independently launched/custom-backend processes. See delegated testing.

Open /subagents to inspect and manage subagent runs.
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.