OpenParable
Skip to content
← Back to skills

Peon Ping Rename

Productivity
peon-ping-rename

Peon 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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:

  1. Extracts the session ID and name
  2. Writes session_names[session_id] = name to .state.json
  3. Immediately updates the terminal tab title via ANSI escape sequence
  4. 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