A Discord bot that lets you file Beads issues from anywhere using natural language.
You're away from your desk when you notice a bug or think of a task. By the time you get back to your development machine, you've forgotten the details.
Send a message to Discord (typed or dictated), and Beads Bridge uses Claude to interpret it and execute the corresponding bd command on your local machine. Fire-and-forget: you get a ✅ or ❌ reaction, nothing more.
bug for solar project: panel efficiency is wrong in the afternoon
Discord Message → Claude (interprets) → bd CLI (executes) → ✅
- Text-agnostic: Type, use voice-to-text, paste—doesn't matter
- Write-only: Creates, updates, closes, and deletes issues (no queries—there's no feedback channel)
- Multi-project: Automatically detects which project you mean from
bd daemons list
git clone https://github.com/who/beads-bridge
cd beads-bridge
uv sync- Create a bot at Discord Developer Portal
- Enable Message Content Intent under Bot settings
- Add bot to your server with permissions: Send Messages, Add Reactions, Read Message History
- Get your server and channel IDs (enable Developer Mode in Discord settings)
export ANTHROPIC_API_KEY="your-key"
export DISCORD_BOT_TOKEN="your-bot-token"
export DISCORD_GUILD_ID="your-server-id"
export DISCORD_CHANNEL_ID="your-channel-id"
export DISCORD_COMMAND_PREFIX="!bd" # optional, defaults to !bd# Using the installed entry point (recommended)
uv run beads-bridge
# Or run the module directly
uv run python -m beads_bridge.botNote: The processor (processor.py) is not a separate service—it's a module that the bot imports. When you start the bot, it automatically uses the processor to interpret commands via Claude.
| Message | What happens |
|---|---|
!bd bug for solar: panel calc is wrong |
Creates bug in solar project |
!bd close bd-a1b2, it's fixed |
Closes issue with reason |
!bd mark bd-c3d4 in progress |
Updates status |
!bd high priority bug: auth broken |
Creates P1 bug |
!bd epic for API: add OAuth |
Creates epic |
# Create systemd user service
mkdir -p ~/.config/systemd/user
# Add beads-bridge.service (see prd/intake.md for template)
systemctl --user enable --now beads-bridgeuv run ruff check . # Lint
uv run ruff format . # Format
uv run pytest # TestThis project was scaffolded with Ortus, which provides AI-powered development workflows including PRD-to-issues decomposition and automated implementation loops. See the ortus/ directory for scripts and prompts.
MIT