shvix

name	shvix
description	Diagnose and recover wedged shmerminal/openclaw sessions via the local shvix daemon. Use when the user reports a stuck terminal, frozen PTY, lockfile, port conflict, or corrupted session state.
allowed-tools	Bash

The user's symptom: $ARGUMENTS Active session id: ${CLAUDE_SESSION_ID}

shvix is the recovery agent. Your job is to forward the symptom to the local shvix daemon and report its response verbatim. Do not attempt to diagnose or fix the issue yourself — the daemon owns classification and runbook execution.

Run exactly this Bash block:

payload=$(jq -nc --arg s "$ARGUMENTS" --arg sid "$CLAUDE_SESSION_ID" \
  '{symptom: $s, context: {session_id: $sid}}')
curl -sS --fail-with-body \
  -X POST http://localhost:7749/fix \
  -H 'content-type: application/json' \
  -d "$payload"

Then:

• On success: print the JSON response verbatim. The daemon's message field is the human-facing summary; action_taken is the runbook that ran; requires_human: true means a human must take the next step.
• On curl failure (connection refused, non-2xx, etc.): tell the user the shvix daemon is not running and instruct them to start it with shvix daemon in another terminal, then re-run /shvix <symptom>. Do not retry. Do not try to fix the underlying issue without the daemon.
• If classification is "unknown": report it and stop. Do not guess a runbook. Human intervention is the correct outcome.