@lsfcy/pi-auto-session-name

Automatically name new Pi terminal sessions from the first user message

Packages

Package details

extension

Install @lsfcy/pi-auto-session-name from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@lsfcy/pi-auto-session-name
Package
@lsfcy/pi-auto-session-name
Version
0.2.0
Published
Nov 11, 2026
Downloads
348/mo · 348/wk
Author
lsfcy
License
MIT
Types
extension
Size
24.5 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/auto-session-name.ts"
  ]
}

Security note

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

README

Pi Auto Session Name

从新 TUI 会话的首条用户消息异步生成标题。另提供 /autoname 手动补命名,不覆盖已有名称。

  • 默认在当前会话的 provider 内按目录价格选择最便宜的文本模型,思考档取该模型支持的最低档。
  • 额外发送首问最多 1000 个 Unicode 字符;不发送助手回复、工具结果或系统提示。
  • 每个新会话自动尝试一次,30 秒超时,不自动重试。模型或认证缺失时不回退。
  • 使用 Pi 已有认证;本包不包含凭据。标题与安全分类记录会写入会话。
  • 仅 TUI 生效;已在 Pi 1.4.0 验证。需要 Node.js 22.19+。

配置

可选文件 ~/.pi/agent/auto-session-name.json,位置遵循 PI_CODING_AGENT_DIR。键名与 pi-composer-predictions 相同,改模型不必改代码:

{
  "model": "provider/model-id",
  "thinkingLevel": "low"
}
  • model:可选,完整模型名 provider/id,id 自身可含 /(如 provider/vendor/model-id)。省略或 null 表示自动:只在当前 provider 内按目录价格选择最便宜的文本模型,跨 provider 不自动挑选;明确指定时可以跨 provider。
  • thinkingLevel:可选,支持 off、minimal、low、medium、high、xhigh、max。省略时取模型支持的最低档;off 表示不向提供方发送思考参数;模型不支持指定档位时停止本次命名,不偷偷降档。
  • 不提供 enabled(与预测插件不同):停用请用 pi remove,避免多出一种「配置关闭但扩展仍加载」的状态。未知键一律视为配置非法。
  • 文件不存在即用默认值(自动选择)。文件存在但内容非法(未知键、类型错误、超过 16KB)时本次不命名并提示检查文件,不回退到猜测的配置,也不把文件内容写入会话或终端。
  • 配置在每次命名时读取:编辑后下一个新会话即生效,无需 /reload。已经命名或已结束的会话不会被改写。
  • /autoname 的确认框会显示实际使用的模型与思考档。

安装

通过 npm 安装:

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

然后在正在运行的 Pi 中执行 /reload,或新开会话。

本地开发

在本包目录执行:

npm ci --ignore-scripts
pi install "$PWD"
npm run check

随后在 Pi 中执行 /reload。宿主依赖由 Pi 提供,无需安装第二份 Pi。

停用

通过 npm 安装时执行 pi remove npm:@lsfcy/pi-auto-session-name;本地路径安装时在包目录执行 pi remove "$PWD"。随后 /reload;本地源码不会被删除。配置文件 auto-session-name.json 需自行删除。

本包以 MIT 许可证公开,源码随 npm 包发布。额外调用与隐私边界见上文;标题与分类记录会写入会话。

维护者为目录所有者。Pi 原生支持同等命名能力或不再使用时,移除 Pi 登记并删除本包;全部不再需要时删除本仓库即可。本包替代原先散落在 agent 目录中的脚本与测试,不新增同步服务或后台任务。