Stats
Links
Categories
claude-discord-status
Show your Claude Code, Claude Desktop, or Cowork activity as Discord Rich Presence.
Like the VS Code Discord extension, but for Claude.
What it shows
- Which app you're using (Claude Code, Desktop, or Cowork)
- What you're doing (editing files, running commands, chatting, exploring code)
- Project name and elapsed time
- Custom buttons (optional — link to your GitHub, portfolio, etc.)
Quick Start
1. Create a Discord Application
- Go to Discord Developer Portal
- Click New Application — name it "Claude Code" (or whatever you like)
- Copy your Application ID
2. Install the plugin
# Clone and install (auto-builds via postinstall)
git clone https://github.com/QuantumInkDev/claude-discord-status.git
cd claude-discord-status
npm install
# Install in Claude Code
claude plugin install ./claude-discord-status
3. Configure
Create the config file at the plugin data directory:
{
"discordAppId": "YOUR_APPLICATION_ID_HERE",
"enabled": true,
"showProjectName": true,
"showFileName": false,
"showElapsedTime": true,
"buttons": [
{ "label": "View Project", "url": "https://github.com/you/project" }
]
}
4. Use Claude
That's it. Start a Claude Code session and your Discord status will update automatically.
How it works
Claude Code hooks ──► Background daemon ──► Discord Rich Presence
(session events) (Node.js process) (IPC connection)
- SessionStart hook spawns a background daemon (if not already running)
- Hook scripts send status updates to the daemon over a Unix socket
- The daemon maintains a persistent Discord IPC connection
- Most-recently-active session wins when multiple terminals are open
- Daemon auto-shuts down after 5 minutes with no active sessions
Configuration
| Option | Default | Description |
|---|---|---|
discordAppId | "" | Required. Discord Application ID |
enabled | true | Toggle the plugin on/off |
showProjectName | true | Display the project directory name |
showFileName | false | Display current file being edited |
showElapsedTime | true | Show how long the session has been active |
idleTimeoutSeconds | 300 | Seconds before marking session as idle |
buttons | [] | Up to 2 clickable buttons with label + url |
Discord Asset Setup (Optional)
For custom icons, upload images in your Discord Application under Rich Presence > Art Assets:
Large images (app type — displayed as main icon):
| Asset Key | Description | Size |
|---|---|---|
claude_code | Claude Code logo | 1024x1024 |
claude_desktop | Claude Desktop logo | 1024x1024 |
claude_cowork | Claude Cowork logo | 1024x1024 |
claude_chat | Claude Chat logo | 1024x1024 |
Small images (action — displayed as overlay badge):
| Asset Key | Description | Size |
|---|---|---|
action_edit | Editing files | 1024x1024 |
action_run | Running commands | 1024x1024 |
action_explore | Exploring codebase | 1024x1024 |
action_chat | Chatting | 1024x1024 |
action_idle | Idle | 1024x1024 |
Requirements
- Node.js 20+
- Discord desktop app running locally
- "Display current activity" enabled in Discord Settings > Activity Privacy
Cross-platform
Works on macOS, Windows, and Linux — wherever Claude Code and Discord both run.
- macOS/Linux: Uses Unix domain sockets
- Windows: Uses named pipes
License
MIT - see LICENSE
Credits
Created by QuantumInkDev