shipp-agent-hq
v1.2.1
Published
Watch your AI agents work in real-time — a live pixel-art office visualizer for Claude Code sessions
Readme
Shipp Agent HQ
Watch your AI agents work in real-time — a live pixel-art office visualizer for Claude Code sessions.
Quick Start
npx shipp-agent-hqThen follow the 3 steps printed in your terminal.
How it works
Shipp Agent HQ runs a local relay server that receives Claude Code hook events and streams them to a shared pixel-art office in your browser. Each Claude session becomes a character that walks around, sits at a desk, and animates based on what it's doing.
Environment variables
| Variable | Default | Description |
|---|---|---|
| PORT | 5175 | Port for the relay server |
| RELAY_TOKEN | (none) | Auth token for WebSocket connections (recommended for public use) |
| RELAY_NAME | My AgentHQ | Display name shown in the directory |
| RELAY_PUBLIC_URL | (none) | Your public tunnel URL (for directory registration) |
Usage with token auth
RELAY_TOKEN=mysecret npx shipp-agent-hqThen connect with: https://pixel-agents-liard.vercel.app/?ws=wss://your-tunnel.trycloudflare.com?token=mysecret
License
MIT — based on pixel-agents
