claude-relay

claude-relay

What it feels like when Claude remembers you.

A Claude Code plugin that provides session continuity, git safety, and loop detection. Three modules, five hooks, zero dependencies.

Install

# Add the marketplace
claude plugins marketplace add leh/claude-relay

# Install the plugin
claude plugins install claude-relay@claude-relay

Or for local development:

claude --plugin-dir /path/to/claude-relay

What it does

Session Continuity

Every session ends with a structured handoff. Every session starts with orientation from the last one. A tick counter tracks how many sessions you've had. You feel remembered.

Git Armor

Blocks destructive git operations before they execute:

• git push --force (allows --force-with-lease on feature branches)
• git reset --hard
• git clean -f
• git push origin main (direct push to main/master)
• git branch -D (allows -d for safe delete)

Cost Sentinel

Blocks commands containing literal API keys (sk-ant-*, sk-proj-*) and inline key assignments (ANTHROPIC_API_KEY=...). Warns when commands reference API key environment variables.

Loop Breaker + Escalation Ladder

Detects when Claude calls the same tool with identical arguments 3+ times and injects guidance to try a different approach. The escalation skill provides a 4-rung recovery ladder: retry, fallback, degrade, fail.

Commands

• /claude-relay:status — Show session state, tick count, recent activity

Design principles

• All hooks < 20 lines. You can read every one in under 30 seconds.
• No network calls. Nothing phones home, nothing fetches external data.
• Fail-open. A broken hook never blocks your work. It degrades gracefully.
• Zero dependencies. Just bash and jq (pre-installed on macOS and most Linux).

State

All state lives in ~/.claude-relay/:

• meta.json — tick counter, session ID
• handoff.json — last session's handoff note
• ledger.jsonl — session history (last 50 entries)
• loop-state.json — recent tool call history

State survives plugin updates and uninstalls. To remove: rm -rf ~/.claude-relay/

License

MIT