Use to force-clear the Volley STATE lock when something has gone wrong - Codex's terminal crashed, was closed, or otherwise left STATE in a bad state. Confirms with the user before clearing. The escape hatch from the concurrency model.
Installs into .claude/skills of the current project.
Are you the author of Unlock?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/ryan-m-frank-unlock)
---
name: unlock
description: Use to force-clear the Volley STATE lock when something has gone wrong - Codex's terminal crashed, was closed, or otherwise left STATE in a bad state. Confirms with the user before clearing. The escape hatch from the concurrency model.
---
# /volley:unlock
Force-clear the lock. The escape hatch.
## Steps for Claude
1. **Read current STATE and show the user.**
```bash
[ -f .volley/STATE ] || { echo "ERROR: .volley/STATE not found. Run /volley:setup first." >&2; exit 1; }
. "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh"
echo "Current STATE:"
cat .volley/STATE
echo ""
AGE=$(volley_state_lock_age .volley/STATE 2>/dev/null) && echo "Lock age: ${AGE}s" || echo "Lock age: unknown"
```
2. **Confirm with the user.** Output:
> "Force-clear this lock? STATE will be reset to ACTIVE=claude, TASK=idle, PID=0. Any work Codex was doing in a terminal tab will NOT be stopped automatically - you'll need to close that tab manually if you want Codex to stop. Confirm with 'yes' to proceed, or 'no' to abort."
Wait for user response. Anything other than `yes` aborts.
3. **Reset STATE.**
```bash
. "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh"
volley_state_write .volley/STATE claude idle 0
echo "Lock cleared."
```
4. **Print the next-step block.**
```bash
. "${CLAUDE_PLUGIN_ROOT}/scripts/lib.sh"
volley_next_step "/volley:status" "Verify the lock is clear and Claude is the active actor."
```
