Peon Ping Rename
Productivitypeon-ping-renamePeon Ping Rename is an Agent Skill for productivity published in the PeonPing/peon-ping repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Rename the current Claude session for peon-ping notifications and terminal tab title. Use when user wants to give this session a custom name like "/peon-ping-rename Auth Refactor". Call with no argument to reset to auto-detect.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/PeonPing/peon-ping/blob/HEAD/skills/peon-ping-rename/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/peon-ping-rename, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
peon-ping-rename
Give the current session a custom name shown in desktop notification titles and the terminal tab title.
How it works
When the user types /peon-ping-rename <name>, a UserPromptSubmit hook intercepts the command before it reaches the model:
- Extracts the session ID and name
- Writes
session_names[session_id] = nameto.state.json - Immediately updates the terminal tab title via ANSI escape sequence
- Returns confirmation (zero tokens used)
On every subsequent hook event, peon.sh reads session_names[session_id] as the highest-priority project name. Multiple tabs in the same repo each get independent names.
Usage
/peon-ping-rename Auth Refactor
/peon-ping-rename API: payments
/peon-ping-rename ← reset to auto-detect
Names are capped at 50 characters. Allowed: letters, numbers, spaces, dots, hyphens, underscores.
Manual fallback (if hook fails)
1. Get the session ID
echo "$CLAUDE_SESSION_ID"
2. Write name to state
python3 -c "
import json, os, time
state_path = os.path.expanduser('~/.claude/hooks/peon-ping/.state.json')
try:
state = json.load(open(state_path))
except:
state = {}
state.setdefault('session_names', {})['SESSION_ID_HERE'] = 'My Session Name'
json.dump(state, open(state_path, 'w'), indent=2)
"
3. Trigger a hook event to refresh the tab title
Submit any prompt — peon.sh will pick up the new name on the next UserPromptSubmit or Stop event.
Reset
/peon-ping-rename
Or remove the session ID from session_names in .state.json directly.
Priority
/peon-ping-rename > CLAUDE_SESSION_NAME env var > .peon-label file > notification_title_script > project_name_map > notification_title_override > git repo name > folder name