Pi Auto Session Title

A small Pi extension that automatically names unnamed sessions using Pi's native ctx.modelRegistry.complete() and pi.setSessionName() APIs.

This project intentionally avoids completeSimple(). It was created after a custom provider repeatedly returned an empty title through that path even though normal Pi model calls worked.

Behavior

• Runs after the first substantive user prompt through before_agent_start.
• Uses ctx.modelRegistry.complete() so title requests use Pi's configured provider/model registry.
• Applies names only through pi.setSessionName().
• Never overwrites an existing/manual name during automatic generation.
• Re-checks the active session and current name after the model request, preventing session-switch and manual-rename races.
• Ignores trivial prompts such as 继续, continue, ok, and next until a substantive request exists.
• Extracts normalized text and output_text response shapes.
• By default, generates the title with the current session model, without a fixed model/provider. For reasoning models, prefers low thinking for fast titles even when the main conversation uses high/max.
• If an explicitly configured different title model times out, switches to the session model; if the session model also fails, uses a sanitized local title.
• Non-timeout primary failures still honor retries before trying any available fallback.
• Removes URLs, absolute paths, and common token-like strings from generated/fallback titles.
• Provides /retitle to explicitly regenerate the current title.

Configuration

For compatibility with pi-session-naming, the extension reads these existing keys from ~/.pi/agent/settings.json:

{
  "session": {
    "titleGeneration": {
      "enabled": true,
      "model": "current",
      "retries": 2,
      "maxLength": 64,
      "timeoutMs": 12000
    }
  }
}

Environment variables override settings:

• PI_AUTO_TITLE_ENABLED
• PI_AUTO_TITLE_MODEL
• PI_AUTO_TITLE_RETRIES
• PI_AUTO_TITLE_MAX_CHARS
• PI_AUTO_TITLE_MAX_SOURCE_CHARS
• PI_AUTO_TITLE_TIMEOUT_MS (default: 12000 per attempt)
• PI_AUTO_TITLE_DEBUG

model defaults to current and follows the active Pi session model on every new title request, including /retitle. Reasoning models use their lowest practical thinking level (prefer low to avoid providers that incorrectly advertise minimal); non-reasoning models do not specify a thinking level. If that model times out or fails, the local heuristic is the final fallback. An explicit provider/model[:thinking] still works as an optional override; if it fails, the plugin attempts the current session model.

If you previously configured a fixed title model, replace it with "model": "current". Also remove any PI_AUTO_TITLE_MODEL environment override that pins a different model.

Local development

npm install
npm test

Load only this extension for a test run:

pi --no-extensions -e .\extensions\auto-session-title.ts

Install from Git

After this repository is published:

pi install git:https://github.com/nonlog/pi-auto-session-title

Remove it with:

pi remove git:https://github.com/nonlog/pi-auto-session-title