peon-ping-use
Set which voice pack (character voice) plays for the current chat session.
How it works
When the user types
/peon-ping-use <packname>
, a
beforeSubmitPrompt hook intercepts the command before it reaches the model and handles it instantly:
- Validates the requested pack exists
- Enables rotation mode in config.json
- Maps the current session ID to the requested pack in .state.json
- Returns immediate confirmation (zero tokens used)
When the hook blocks the message, Cursor keeps your cursor in the input field so you can type your next message right away.
The hook scripts (
scripts/hook-handle-use.sh
and
scripts/hook-handle-use.ps1
) do all the work - this SKILL.md file exists solely for discoverability in the
command autocomplete menu.
Usage
Users can invoke this by typing:
/peon-ping-use peasant
/peon-ping-use glados
/peon-ping-use sc_kerrigan
If the hook is not installed or fails, you can fallback to manual execution by following the instructions below.
Manual fallback (if hook fails)
If for some reason the hook doesn't intercept the command, follow these steps:
1. Parse the pack name
Extract the pack name from the user's request. Common pack names:
- — Warcraft Peon
- — Portal's GLaDOS
- — StarCraft Kerrigan
- — Warcraft Peasant
- — Star Wars HK-47
2. List available packs
Run this command to see installed packs:
bash
bash "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/peon.sh packs list
Parse the output to verify the requested pack exists.
3. Get session ID
The session ID is available in the environment variable
. Read it:
bash
echo "$CLAUDE_SESSION_ID"
If empty (Cursor users): Use
as the key in
. This applies the pack to all sessions without explicit assignment. Add
session_packs["default"] = {"pack": "PACK_NAME", "last_used": UNIX_TIMESTAMP}
.
4. Update config to enable agentskill mode
Read the config file:
bash
cat "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/config.json
Required: Set
to
. The pack must exist in the packs directory; if the assigned pack is missing or invalid, peon-ping falls back to
and removes the stale assignment. The hook also adds the pack to
(manual fallback can do the same).
Example config after setup:
json
"pack_rotation_mode": "agentskill",
"pack_rotation": ["peasant", "peon", "ra2_kirov"]
If
is
or
, change it to
. If the requested pack is not in
, add it.
5. Update state to assign pack to this session
Read the state file:
bash
cat "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/.state.json
Update the
object to map this session to the requested pack. If
doesn't exist, create it:
json
{
"session_packs": {
"SESSION_ID_HERE": "pack_name_here"
}
}
Use StrReplace or edit the JSON to add/update the entry:
- If exists: add or update the session ID key
- If doesn't exist: add it after the opening brace
6. Confirm to user
Report success with a message like:
Voice set to [PACK_NAME] for this session
Rotation mode: agentskill
Error handling
- Pack not found: List available packs and ask user to choose one
- No session ID: Inform user this feature requires Claude Code
- File read/write errors: Report the error and suggest manual config editing
Example interaction
User: Use GLaDOS voice for this chat
Assistant: [Lists packs to verify glados exists]
Assistant: [Gets session ID]
Assistant: [Updates config.json to set pack_rotation_mode: "agentskill"]
Assistant: [Updates .state.json to set session_packs[session_id] = "glados"]
Assistant: Voice set to GLaDOS for this session
Rotation mode: agentskill
Cursor compatibility note
Cursor doesn't expose session IDs. Use
instead: when doing the manual fallback, add
"default": {"pack": "peasant", "last_used": 0}
to
. This applies the voice to sessions without explicit assignment (including Cursor chats).
Reset to default
To stop using a specific pack for this session, remove the session ID from
in
, or change
back to
or
.