Getting started

Requirements

Component	Supported version
Pi	0.84.1
pi-subagents	0.40.0
pi-subagent-models	0.2.0

Install the package

Install the published npm package:

pi install npm:pi-subagent-models@0.2.0

The package must load before pi-subagents. Keep all other package entries unchanged:

{
  "packages": [
    "npm:pi-subagent-models@0.2.0",
    "npm:pi-subagents@0.40.0"
  ]
}

Restart Pi or run /reload after changing package order.

Caution

A later pi-subagents version may change the event contracts used for slash commands, delegation, or RPC. Test every launch path before changing the pinned version.

Verify the installation

Run:

pi list

Confirm that pi-subagent-models appears before pi-subagents. In Pi, type /subagents-model and /subagents-model-session; both commands should appear in completion.

Tip

Start with Default in both scopes. This confirms the commands load without changing native child model resolution.

Choose a model

Use the global command when every Pi terminal should share the same child model:

/subagents-model

Use the session command when only the active session branch should differ:

/subagents-model-session

Selecting a model opens a second selector for its supported thinking levels.