Agent skill

Peon-Ping Session Rename

Gives the current coding session a custom name that appears in peon-ping desktop notification titles and the terminal tab title, or resets it to automatic.

MITAuto-check passedProductivity & Automation

Install Peon-Ping Session Rename

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/peon-ping-rename .claude/skills/peon-ping-rename && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .claude/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/peon-ping-rename .agents/skills/peon-ping-rename && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .agents/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/peon-ping-rename .cursor/skills/peon-ping-rename && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .cursor/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/PeonPing/peon-ping.git --path skills/peon-ping-rename

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/peon-ping-rename .gemini/skills/peon-ping-rename && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .gemini/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/peon-ping-rename .github/skills/peon-ping-rename && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .github/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add PeonPing/peon-ping --skill peon-ping-rename -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install PeonPing/peon-ping peon-ping-rename --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/PeonPing/peon-ping.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/peon-ping-rename .opencode/skills/peon-ping-rename && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "peon-ping-rename" agent skill from https://github.com/PeonPing/peon-ping/tree/main/skills/peon-ping-rename into .opencode/skills/peon-ping-rename/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "peon-ping-rename", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: peon-ping-rename
GitHub stars: 5.1k
Token cost: ~539 tokens
SKILL.md length: 173 words
Files: 1
Skills in repo: 7
Repo updated: Oct 6, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Gives the current coding session a custom name that appears in peon-ping desktop notification titles and the terminal tab title, or resets it to automatic.

Works in 3 steps: Get the session ID → Write name to state → Trigger a hook event to refresh the tab…
Telling apart several terminal tabs working in the same repository
SKILL.md covers How it works, Usage, Manual fallback (if hook fails) and Reset, plus 1 more section
Calls python3

What it does

Typing `/peon-ping-rename Auth Refactor` sets a name for the session. A UserPromptSubmit hook catches the command before it reaches the model, saves the name against the session ID in peon-ping's `.state.json`, retitles the terminal tab with an ANSI escape sequence and confirms, so no tokens are spent. Tabs open in the same repository can each have their own name, and running the command with no argument returns to automatic detection.

Names can be up to 50 characters of letters, numbers, spaces, dots, hyphens and underscores. If the hook fails, a manual fallback reads the session ID from the environment and writes the name into the state file with a short Python command, after which any prompt refreshes the title. The session name outranks every other source of project name, including the environment variable, label file, title script and the Git repository name.

When your agent uses it

Telling apart several terminal tabs working in the same repository
Making desktop notifications show a meaningful session name
Resetting a session name back to automatic detection

Example prompts

“/peon-ping-rename Payments API”
“Rename this session to Auth Refactor so my notifications are easier to tell apart.”
“Reset this session's name to the auto-detected one.”

Requirements

peon-ping installed with its UserPromptSubmit hook
Python 3, only for the manual fallback

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Get the session ID
Write name to state
Trigger a hook event to refresh the tab title

What it can do on your machine

Read from SKILL.md and the folder at commit de4ada7. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Peon-Ping Session Rename loads about 539 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 173 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~61
When it runs · the whole SKILL.md, loaded when a task matches: ~539

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from PeonPing/peon-ping at commit de4ada7, republished under its MIT licence (© PeonPing). 173 words, ~539 tokens.

Download SKILL.mdSave it as .claude/skills/peon-ping-rename/SKILL.md (or your agent's skills folder).

name: peon-ping-rename
description: 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.
user-invocable: true
license: MIT
metadata.author: PeonPing
metadata.version: 1.0

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

bash

echo "$CLAUDE_SESSION_ID"

2. Write name to state

bash

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

Files

Just SKILL.md in skills/peon-ping-rename of PeonPing/peon-ping.

Open the folder on GitHubat commit de4ada7

Compare with similar skills

Peon-Ping Session Rename next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Peon-Ping Session Rename compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Peon-Ping Session Rename this skillPeonPing/peon-ping	5.1k	—	~539	Automated safety check: Pass	MIT	4 days ago
Discord Bot Architectdavila7/claude-code-templates	33k	7 repos	~2k	Automated safety check: Pass	MIT	today
cmux Diagnosticsmanaflow-ai/cmux	28k	1 repos	~819	Automated safety check: Pass	Custom licence	today
Wp Plugin Developmentgambitph/Stackable	351	3 repos	~999	Automated safety check: Pass	GPL-3.0	4 days ago
Chat SDKdatabuddy-analytics/Databuddy	1.2k	—	~2.6k	Automated safety check: Pass	AGPL-3.0	today
Cronalytics8bit64k/cronalytics	112	—	~4.7k	Automated safety check: Pass	MIT	3 mo ago

Similar skills

Discord Bot Architect
davila7/claude-code-templates
Specialized skill for building production-ready Discord bots.
33k GitHub starsUsed in 7 repos~2k tokens
Productivity & AutomationAuto-check passed
cmux Diagnostics
manaflow-ai/cmux
Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.
28k GitHub starsUsed in 1 repo~819 tokens
Productivity & AutomationAuto-check passed
Wp Plugin Development
gambitph/Stackable
A skill your agent uses when developing WordPress plugins: architecture and hooks, activation/deactivation/uninstall, admin UI and Settings API, data storage, cron/tasks, security…
351 GitHub starsUsed in 3 repos~999 tokens
Agent WorkflowsAuto-check passed
Chat SDK
databuddy-analytics/Databuddy
Build multi-platform chat bots with Chat SDK (chat npm package).
1.2k GitHub stars~2.6k tokensUpdated today
Agent WorkflowsAuto-check passed
Cronalytics
8bit64k/cronalytics
Analyze, diagnose, and optimize Hermes cron jobs via the cronalytics CLI.
112 GitHub stars~4.7k tokensUpdated 3 mo ago
Productivity & AutomationAuto-check passed
Build Plugin
opentabs-dev/opentabs
Complete plugin development workflow: build, test, icon, troubleshoot, and setup.
968 GitHub stars~190 tokensUpdated 8 days ago
Agent WorkflowsAuto-check passed

Questions about Peon-Ping Session Rename

What does Peon-Ping Session Rename do?

Gives the current coding session a custom name that appears in peon-ping desktop notification titles and the terminal tab title, or resets it to automatic. Typing `/peon-ping-rename Auth Refactor` sets a name for the session.json`, retitles the terminal tab with an ANSI escape sequence and confirms, so no tokens are spent.

When should I use Peon-Ping Session Rename?

Peon-Ping Session Rename fits situations like: telling apart several terminal tabs working in the same repository; making desktop notifications show a meaningful session name; resetting a session name back to automatic detection.

How do I install Peon-Ping Session Rename in Claude Code?

Run `npx skills add PeonPing/peon-ping --skill peon-ping-rename -a claude-code`. Or copy the skill folder (skills/peon-ping-rename in PeonPing/peon-ping) into .claude/skills/peon-ping-rename in your project. Claude Code loads it when a task matches its description.

How do I install Peon-Ping Session Rename in Codex?

Run `npx skills add PeonPing/peon-ping --skill peon-ping-rename -a codex`. Or copy the skill folder (skills/peon-ping-rename in PeonPing/peon-ping) into .agents/skills/peon-ping-rename in your project. Codex loads it when a task matches its description.

Can I use Peon-Ping Session Rename in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add PeonPing/peon-ping --skill peon-ping-rename -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/peon-ping-rename, .gemini/skills/peon-ping-rename, .github/skills/peon-ping-rename and .opencode/skills/peon-ping-rename in your project.

What does Peon-Ping Session Rename need to run?

Going by SKILL.md and its folder, Peon-Ping Session Rename needs the command-line tools its instructions call (python3). Our summary lists: peon-ping installed with its UserPromptSubmit hook; Python 3, only for the manual fallback.

Does Peon-Ping Session Rename access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Peon-Ping Session Rename safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Peon-Ping Session Rename use?

Peon-Ping Session Rename is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Peon-Ping Session Rename use?

About 539 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Peon-Ping Session Rename?

Skills that share tags, products or a category with Peon-Ping Session Rename: Discord Bot Architect (davila7/claude-code-templates, 33k stars), cmux Diagnostics (manaflow-ai/cmux, 28k stars), Wp Plugin Development (gambitph/Stackable, 351 stars) and Chat SDK (databuddy-analytics/Databuddy, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Peon-Ping Session Rename?

PeonPing (a GitHub organization) maintains it in PeonPing/peon-ping, which has 5,067 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 6, 2026.

Source: PeonPing/peon-ping on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Peon-Ping Session Rename

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

peon-ping-rename

How it works

Usage

Manual fallback (if hook fails)

1. Get the session ID

2. Write name to state

3. Trigger a hook event to refresh the tab title

Reset

Priority

Files

Compare with similar skills

Similar skills

More from PeonPing/peon-ping

Related

Questions about Peon-Ping Session Rename