@tinysquid/pi-auto-session-name

Auto-generates short, descriptive names for pi coding agent sessions: after the first turn, a (configurable) model summarizes the opening prompt into a 3–8 word title and sets it as the session name.

Install

pi install npm:@tinysquid/pi-auto-session-name

For local development:

ln -s $(pwd)/auto-session-name/auto-session-name.ts ~/.pi/agent/extensions/auto-session-name.ts

Configuration

Config file ~/.pi/agent/auto-session-name.json pins the naming model and request options:

{
  "provider": "google",
  "model": "gemma-4-26b-a4b-it",
  "temperature": 0.2,
  "thinking": "off"
}

• provider, model — pin the naming model (see below).
• temperature — sampling temperature passed to the naming request as-is. Must be between 0 and 2; values outside that range (or non-numbers) are treated as malformed and repaired away. Omitted by default (provider default applies). Providers may drop it where they forbid it (Anthropic ignores it when thinking is enabled, and only accepts 0–1).
• thinking — reasoning level for the naming request: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max". Defaults to "off". The level is clamped to what the model supports (model-specific level mappings are respected).

The file is read at naming time, so edits apply on the next session — no reload required. When a file is generated or repaired (see below), the rewrite is schema-normalizing: only provider, model, temperature, and thinking are kept, so any extra keys are dropped.

If no config file exists, one is generated on first use, pinning the cheapest available model by input token cost, respecting session model scoping (enabledModels / --models); if none, the active session model is used. A config file with no usable provider/model — unparseable JSON, or missing/invalid fields — is likewise regenerated from the default pick (with a warning). A file with a valid provider/model is never overwritten: malformed — but not merely missing — temperature or thinking values are dropped and the file is rewritten without them (with a warning), keeping the configured model. Missing keys are simply left unset (defaults apply).

A configured model that is unknown or has no configured credentials falls back to the default pick (with a warning).

Behavior notes

• In the interactive TUI, naming runs in the background so the prompt is never delayed. Quitting or switching sessions within the ~1–2s naming window loses the name. In one-shot modes (-p, --json), the turn ends slightly later while the name is generated.
• Fires at most once per session, and only if the session has no name yet.
• Failures are logged to the terminal ([auto-session-name] ...), never surfaced in the UI.