Peon-ping peon-ping-rename

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.

install

source · Clone the upstream repo

git clone https://github.com/PeonPing/peon-ping

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/PeonPing/peon-ping "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/peon-ping-rename" ~/.claude/skills/peonping-peon-ping-peon-ping-rename && rm -rf "$T"

manifest: skills/peon-ping-rename/SKILL.md

source content

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] = name

.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

Stop

event.

Reset

/peon-ping-rename

Or remove the session ID from

session_names

.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