@oipsanthony/pi-session-title

Generate and synchronize concise Pi session titles after completed conversations.

Packages

Package details

extension

Install @oipsanthony/pi-session-title from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@oipsanthony/pi-session-title

Package: @oipsanthony/pi-session-title
Version: 0.3.5
Published: Aug 26, 2026
Downloads: 1,116/mo · 316/wk
Author: oipsanthony
License: MIT
Types: extension
Size: 38.9 KB
Dependencies: 1 dependency · 2 peers

Pi manifest JSON

{
  "extensions": [
    "extensions/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-session-title

在 Pi 完成首轮对话后自动生成简短标题，并同步到 session name、terminal tab/window title 和 Herdr pane。

安装

pi install npm:@oipsanthony/pi-session-title

扩展只在 Pi TUI 中自动运行。默认每新增 4 个完整用户轮次重新检查一次标题。通过 Pi 内置 /name 设置的名称不会被自动覆盖。

命令

命令	操作
`/session-title`	根据当前对话重新生成标题
`/session-title status`	查看启用状态、当前名称和使用的模型

需要直接指定名称时，请使用 Pi 内置 /name。

配置

创建 ${PI_CODING_AGENT_DIR:-~/.pi/agent}/pi-session-title.json：

{
  "enabled": true,
  "model": "@tiny",
  "thinkingLevel": "minimal",
  "timeoutMs": 30000,
  "maxTokens": 40,
  "maxLength": 48,
  "refreshTurns": 4,
  "terminalTitle": {
    "enabled": true,
    "template": "π {title} ({cwd})"
  },
  "herdr": {
    "enabled": true
  }
}

model 支持 provider/modelId 或 pi-model-roles 中的 @role。省略时使用当前 Pi 模型；配置的模型不可用时也会回退当前模型。

thinkingLevel 会覆盖角色中配置的 thinking level。需要沿用角色设置时，请省略该字段。

refreshTurns 设为 0 可关闭周期性重评估。terminalTitle.template 支持 {title} 和 {cwd}。修改配置后执行 /reload。

Herdr

在 Herdr pane 中，扩展只同步 display title，不会覆盖用户手动设置的 pane label。Herdr 不可用时，Pi session name 和 terminal title 仍会正常更新。