用途:为当前 Claude 会话起一个自定义名称,该名称会显示在 peon-ping 桌面通知标题和终端标签标题中,方便在同一仓库的多个标签间区分会话。
主要能力:通过 /peon-ping-rename <name> 命令设置名称;名称写入 .state.json 的 session_names[session_id];立即用 ANSI 转义序列更新终端标签标题;命令由 UserPromptSubmit 钩子在到达模型前拦截处理,消耗零 token;后续每次钩子事件中 peon.sh 都会读取该名称作为最高优先级的项目名。同一仓库的多个标签各自拥有独立名称。
用法:/peon-ping-rename Auth Refactor 设置名称;/peon-ping-rename 不带参数时重置为自动检测。名称上限 50 字符,允许字母、数字、空格、点、连字符和下划线。
手动兜底(钩子失效时):先用 echo "$CLAUDE_SESSION_ID" 获取会话 ID,再通过 python3 脚本把名称写入 ~/.claude/hooks/peon-ping/.state.json 的 session_names 中,然后提交任意提示触发钩子事件以刷新标签标题。
重置:运行 /peon-ping-rename,或直接在 .state.json 中删除对应会话 ID。
优先级顺序:/peon-ping-rename > CLAUDE_SESSION_NAME 环境变量 > .peon-label 文件 > notification_title_script > project_name_map > notification_title_override > git 仓库名 > 文件夹名。
限制:未提供关于收费、平台支持范围及具体报错处理的信息。