pi-session-namer

@d3ara1n/pi-session-namer

Auto-name pi sessions using a cheap side agent.

On the first user prompt of a new session, calls a lightweight side agent model to generate a concise session title, then sets it via pi.setSessionName(). Subsequent turns are skipped with near-zero overhead.

Features

• Zero-config: Works out of the box with pi-model-roles' utility role
• First-turn only: Adds ~0.5-1s latency on the first prompt, zero overhead after
• Graceful fallback: If the side agent fails, truncates the user prompt as name
• Manual rename: /namer:rename to regenerate at any time

Configuration

In ~/.pi/agent/settings.json:

{
  "sessionNamer": {
    "enabled": true,
    "sideAgentRole": "utility",
    "maxLength": 50,
    "language": "zh"
  }
}

Field	Default	Description
enabled	true	Global on/off switch
sideAgentRole	"utility"	pi-model-roles role for the naming side agent
maxLength	50	Maximum name length in characters

Project-level .pi/settings.json overrides global settings.

Commands

Command	Description
/namer	Show status and config
/namer on	Enable auto-naming
/namer off	Disable auto-naming
/namer:rename	Regenerate session name from last prompt

Dependencies

• @d3ara1n/pi-model-roles — model role resolution

Install

Add to ~/.pi/agent/settings.json:

{
  "extensions": [
    "/path/to/pi-extensions/packages/pi-session-namer"
  ]
}