Relay

relay


CLI daemon that monitors [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions and generates structured handoffs to preserve context across session boundaries.

When Claude Code approaches its context limit, relay saves the session state as a markdown handoff, optionally kills the session, and restarts it with the handoff injected — so you never lose your thread.

Features

• Real-time TUI — monitor all active Claude Code sessions (context %, tokens, model, cost)
• Web dashboard — browser-based GUI with the same capabilities, accessible remotely
• Auto-handoff — detects context saturation, saves state, kills & restarts with continuity
• Structured handoffs — goal, current focus, last assistant state, recent tools, files touched
• Git auto-commit — commits work before handoff so nothing is lost
• Hook integration — installs Claude Code hooks (Stop, statusLine) automatically
• Shell wrapper — transparent claude wrapper that handles restart loops
• Multi-task orchestration — decompose work into a plan, run tasks sequentially with dependency resolution
• Discord / Slack notifications — webhook alerts on every handoff

Install

One-liner

curl -fsSL https://raw.githubusercontent.com/LuluHow/relay/main/install.sh | bash

From source

git clone https://github.com/LuluHow/relay.git
cd relay
cargo build --release
mkdir -p ~/.local/bin
cp target/release/relay ~/.local/bin/

# Ensure ~/.local/bin is in your PATH
export PATH="$HOME/.local/bin:$PATH"

relay init

Then add to your shell rc file (`~/.zshrc` or `~/.bashrc`):

export PATH="$HOME/.local/bin:$PATH"
source ~/.relay/claude-wrapper.sh

From GitHub releases

Download the binary for your platform from [Releases](https://github.com/LuluHow/relay/releases), then:

chmod +x relay
mkdir -p ~/.local/bin
mv relay ~/.local/bin/
export PATH="$HOME/.local/bin:$PATH"
relay init
# Add