Disclaude

disclaude.com

A Discord bot for managing persistent Claude Code sessions. Each session gets its own channel - just type to talk to Claude.

How It Works

1. Create a session with /claude new myproject /path/to/project
2. A new channel #claude-myproject is created in the "Claude Sessions" category
3. Just type in that channel - your messages go directly to Claude
4. Claude's output streams back to the channel automatically
5. Scroll up to see the full conversation history
6. Drop into the terminal anytime with tmux attach -t claude-myproject

Features

• Channel per session - Each Claude session gets its own Discord channel
• Just type - No commands needed, messages go straight to Claude
• Live output - Claude's responses stream to the channel in real-time (with ANSI colors)
• Interactive prompts - When Claude shows numbered options, clickable buttons appear
• Persistent - Sessions run in tmux, survive disconnects
• Auto-reconnect - Bot automatically reconnects to existing sessions on restart
• Terminal access - Attach directly via tmux whenever you want

Prerequisites

• Node.js 18+
• tmux (brew install tmux on macOS)
• Claude Code CLI installed and authenticated
• A Discord server where you have permission to create channels

Setup

1. Create a Discord Application

1. Go to Discord Developer Portal
2. Click "New Application"
3. Go to Bot → Click "Reset Token" → Copy the token
4. Enable Message Content Intent under Privileged Gateway Intents
5. Go to OAuth2 → URL Generator:
   • Scopes: bot, applications.commands
   • Bot Permissions: Send Messages, Manage Channels, Embed Links, Add Reactions, Read Message History
6. Open the generated URL to invite the bot to your server

2. Configure

Create a .env file:

# Discord Bot Token
# Get from: https://discord.com/developers/applications -> Your App -> Bot -> Reset Token
DISCORD_TOKEN=your_bot_token_here

# Discord Application Client ID
# Get from: https://discord.com/developers/applications -> Your App -> OAuth2 -> Client ID
DISCORD_CLIENT_ID=your_client_id_here

# Guild/Server ID
# Enable Developer Mode: Discord Settings -> Advanced -> Developer Mode
# Then right-click your server -> Copy Server ID
DISCORD_GUILD_ID=your_guild_id_here

# Default working directory for new sessions (optional)
DEFAULT_DIRECTORY=/path/to/your/projects

# Category name for session channels (optional, default: "Claude Sessions")
CATEGORY_NAME=Claude Sessions

# Allowed Discord user IDs - HIGHLY RECOMMENDED
# Right-click your username -> Copy User ID (enable Developer Mode)
# Comma-separated for multiple users
ALLOWED_USERS=123456789012345678

# Auto-delete messages older than N days (optional, default: never)
MESSAGE_RETENTION_DAYS=7

3. Run

npm install
npm start

For development (with hot reload):

npm run dev

Commands

Command	Description
/claude new <name> [directory]	Create a new session + channel
/claude list	List all active sessions
/claude sync	Reconnect orphaned tmux sessions to Discord channels
/claude end	End the session (run in session channel)
/claude output [lines]	Dump recent output (run in session channel)
/claude attach	Get the tmux attach command

Usage

In Discord:

/claude new api-server ~/Dev/my-api

→ Creates #claude-api-server channel

In the channel:

Help me add rate limiting to the /users endpoint

→ Message goes to Claude, response streams back

In Terminal:

tmux attach -t claude-api-server

→ Full terminal access to the same session

Architecture

Discord Channel                tmux Session
     │                              │
     │  "Add rate limiting"         │
     └────────────────────────────► │ claude (CLI)
                                    │
     ┌────────────────────────────◄ │
     │  [Claude's response...]      │
     ▼                              │
  Channel                           │

Sessions are standard tmux sessions prefixed with claude-. The bot:

1. Creates tmux sessions running the claude CLI
2. Sends your Discord messages to the session via tmux send-keys
3. Polls for new output and streams it back to Discord

Security

This bot can execute arbitrary code on your machine. Anyone who can send messages to a session channel can instruct Claude to run commands, edit files, etc.

User Whitelist (Required)

Always set ALLOWED_USERS in your .env:

# Single user
ALLOWED_USERS=123456789012345678

# Multiple users
ALLOWED_USERS=123456789012345678,987654321098765432

To get your Discord user ID:

1. Discord Settings → Advanced → Enable Developer Mode
2. Right-click your username → Copy User ID

Without ALLOWED_USERS, the bot warns at startup and allows anyone in the guild to use it.

Additional Recommendations

• Enable 2FA on your Discord account
• Never commit .env - it's in .gitignore by default
• Regenerate your bot token immediately if exposed (Discord Developer Portal → Bot → Reset Token)
• Run in a VM/container for additional isolation
• Keep the guild private - don't invite untrusted users

Bot Logs

The bot creates a #bot-logs channel in the Claude Sessions category that logs:

• Session creation/deletion
• File edits detected
• Errors and warnings

Environment Variables

Variable	Required	Description
DISCORD_TOKEN	Yes	Bot token from Discord Developer Portal
DISCORD_CLIENT_ID	Yes	Application ID from Discord Developer Portal
DISCORD_GUILD_ID	Yes	Server ID (right-click server → Copy ID)
DEFAULT_DIRECTORY	No	Default working directory for new sessions
CATEGORY_NAME	No	Category name for session channels (default: "Claude Sessions")
ALLOWED_USERS	No*	Comma-separated Discord user IDs (* highly recommended)
MESSAGE_RETENTION_DAYS	No	Auto-delete messages older than N days