Discord bot that bridges messages to AI coding agents. Supports Claude Code, OpenCode, and Codex CLI.
Fork of cord with multi-agent support and enhanced features.
- Multi-agent support — Claude Code, OpenCode, Codex (switch via config)
- BRB mode — Agent asks questions via Discord buttons when you're away
- Direct messages — Chat with the bot privately via DMs
- Encrypted config —
tether configstores tokens with AES-256-GCM encryption - Access control — User, role, and channel allowlists
- Rate limiting — Per-user sliding window
- Session management — Turn limits, duration limits, pause/resume
- Smart threads — Auto-naming, channel context for new conversations
- Resilient — Exponential backoff on connection failures
# Install
bun add -g @thesammykins/tether
# Configure
tether config set DISCORD_BOT_TOKEN # paste token (hidden input)
tether config set AGENT_TYPE claude # or: opencode, codex
# Start Redis + Tether
redis-server &
tether startThen @mention the bot in your Discord server.
| Guide | Description |
|---|---|
| Installation | Prerequisites, install methods, quick setup |
| Discord Setup | Bot creation, permissions, intents, invite link |
| Agent Setup | Claude Code / OpenCode / Codex install and auth |
| Configuration | All config keys, encrypted secrets, resolution chain |
| CLI Reference | Every tether command with examples |
| Architecture | System design, message flow, middleware pipeline |
| Troubleshooting | Common problems and solutions |
| HTTP API | REST API for external scripts and webhooks |
bun test # Run all tests
bun test tests/adapters/ # Adapter tests only
bun test tests/middleware/ # Middleware tests only
bun test tests/features/ # Feature tests onlyNo message content or user data is stored. Only thread-to-session mappings and channel config persist. Messages pass through Redis transiently and are discarded after processing.
MIT