Open Source · MIT

Claude Code.
In Discord.

Run Claude Code from Discord. It executes on your machine and stays reachable from any channel.

Discord
C
my-workspace
Projects
# api-rewrite
# frontend
# infra
Threads
💬 add-auth
💬 fix-pagination
# api-rewrite
G
gorka Today 11:42
migrate auth to JWT, add refresh token rotation
AI
Claude Today 11:42
Reading 8 files…
Found auth module. Writing tests first, then wiring refresh token rotation…
Message #api-rewrite
Local runs on your machine
your code stays yours
extra API cost
uses your Claude Code auth
MIT open source
self-hosted, no lock-in

Built for daily use.
Not for demos.

The Telegram version proved remote coding could work. But once you have more than one project, one chat becomes noise. Discord already solves that with channels and threads.

Thread branching came from the architecture, not a gimmick. Start a thread, inherit parent context, and optionally attach a worktree. Parallel tasks stay separate without losing context.

Same channels, same notifications, same search — with actual repo access added.

Read the original thread
my-workspace
C
🦞
Agents
# api-rewrite Claude
# research OpenClaw
# deploys CI bot
Threads
💬 add-auth
💬 fix-pagination
🦞
OpenClaw
The agent platform for Discord
openclaw.dev →

If your server already runs bots, this fits in cleanly. Keep planning, research, deploy bots, and Claude Code in one workspace instead of splitting across tools.

Why Discord works.

Discord gives you channels, threads, commands, search, and mobile notifications out of the box. That's the scaffolding async code work actually needs.

# channel
= Project

Each project gets its own working directory, session, and settings.

💬 thread
= Branch

Create a thread to branch work without dropping parent context.

📱 mobile
= Your terminal

Start from phone, get notified on completion, and review results anywhere.

Real repo access.
Not canned chat.

Claude Code reads the codebase, runs commands, manages git, and executes tests. This is execution, not generic suggestions.

claude-on-discord puts that capability in the same place your team already works. Start a task, check progress later, continue from any device.

Works with your existing bots

Keep Claude Code alongside research, deploy, and ops bots in the same server. Clear lanes, less tool switching.

Threads for safe parallel work

Try risky work in a thread first. Keep it, merge it, or drop it without destabilizing the main lane.

Async by default

Runs continue on your machine until complete. You get updates in Discord and can interrupt when needed.

Start from your phone.
Ship from anywhere.

SSH and terminal apps still expect constant attention. Discord is already on your phone, handles reconnects, and pushes notifications. It fits async work better.

Terminal-first remote workflow
  • SSH in first, set up a session
  • Keep Tmux alive or lose everything
  • Mosh for flaky mobile connections
  • Mobile input is awkward for command-heavy workflows
  • No notifications — you have to check
claude-on-discord
  • Send a task from phone in seconds
  • Run continues on your machine unattended
  • Discord notifies you when it's done
  • Review output from anywhere
  • Interrupt mid-run if something's wrong

Core capabilities.

#
thread branches

Create a thread and keep parent context. Optional worktree for clean parallel changes.

#
channel sessions

Each channel keeps its own working dir, model, history, and system prompt.

#
multi-guild

One bot, multiple servers. Configure with DISCORD_GUILD_IDS.

#
mention guardrails

In shared guild channels, runs require explicit mention. No random wakeups.

#
live status

Stream output in one message with Interrupt and Abort controls.

#
pr workflow

/pr open, draft, status, merge from Discord.

#
role prompts

Set different behavior per channel and keep it persistent.

#
mcp loading

Automatically loads .claude/mcp.json from your project.

#
direct shell

/bash and !command for direct command execution.

#
diff delivery

/diff sends a patch file so review works cleanly on mobile.

Up in five minutes.

bash
# Clone and install
git clone https://github.com/spanishflu-est1918/claude-on-discord
cd claude-on-discord && bun install

# Interactive setup: writes .env, prints invite URL
bun run setup

# Start
bun start
No extra API key
Uses your existing Claude Code credentials.
Interactive setup wizard
Writes your .env, generates your bot invite URL.
Needs: Bun + Claude Code

Clear next steps.

What's live and what's next.

Shipped
Live
🌐 Multi-guild support

One bot can run across multiple Discord servers with DISCORD_GUILD_IDS.

🛡️ Shared-channel mention guardrails

In shared guild channels, runs require an explicit @hermes_claude mention.

🌿 Thread worktrees

Thread-level git worktrees for isolated parallel work.

Planned
Next
🎤 Interview mode before execution

Collect key constraints first, then run with a clear plan.

📦 npx install flow

Install and bootstrap without cloning the repo.

Codex as alternate runner

Optional OpenAI Codex backend per channel.

🧭 Guided fork flow

Suggest and create thread forks based on task size and risk.

🪝 Channel webhooks

Route signed external events directly into target channels.

💰 Cost and usage dashboard

Track spend and turn volume by server, channel, and model.