{"id":30688898,"url":"https://github.com/zebbern/claude-code-discord","last_synced_at":"2025-09-02T01:04:03.094Z","repository":{"id":311957617,"uuid":"1045734998","full_name":"zebbern/claude-code-discord","owner":"zebbern","description":"A Discord bot that brings Claude Code to your channels so you can chat, run shell/git, and manage branches. Access from any local, VM, or Docker instance with full capebilty of claude code!","archived":false,"fork":false,"pushed_at":"2025-08-28T00:07:54.000Z","size":50,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-28T02:24:24.350Z","etag":null,"topics":["anthropic","anthropic-claude","automation-framework","awesome","awesome-list","awesome-lists","claude","claude-ai","claude-ai-bot","claude-code","claude-code-commands","claude-code-discord","developer","discord-api","discord-bot","opus","sonnet-4","tools-and-automation"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zebbern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-27T16:26:27.000Z","updated_at":"2025-08-28T00:07:57.000Z","dependencies_parsed_at":"2025-08-28T02:28:30.129Z","dependency_job_id":null,"html_url":"https://github.com/zebbern/claude-code-discord","commit_stats":null,"previous_names":["zebbern/claude-code-discord"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zebbern/claude-code-discord","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fclaude-code-discord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fclaude-code-discord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fclaude-code-discord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fclaude-code-discord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zebbern","download_url":"https://codeload.github.com/zebbern/claude-code-discord/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fclaude-code-discord/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273213992,"owners_count":25065061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anthropic","anthropic-claude","automation-framework","awesome","awesome-list","awesome-lists","claude","claude-ai","claude-ai-bot","claude-code","claude-code-commands","claude-code-discord","developer","discord-api","discord-bot","opus","sonnet-4","tools-and-automation"],"created_at":"2025-09-02T01:02:22.126Z","updated_at":"2025-09-02T01:04:03.076Z","avatar_url":"https://github.com/zebbern.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# claude-code-discord\n\n\u003ckbd\u003e\n\n| Advantage                                   | Details                                                                                     | Status |\n|---------------------------------------------|---------------------------------------------------------------------------------------------|:------:|\n| Use Claude Code Anywhere                    | Host locally (VM / Docker / cloud) and send commands via the Discord API                    | ✅     |\n| Centralized collaboration                   | Run commands and discuss results where your team already communicates                       | ✅     |\n| Branch-aware organization                   | Maps Git branches to channels/categories so feature work stays separated                    | ✅     |\n| Immediate, shareable feedback               | Execute `/git`, `/shell`, or `/claude` and get outputs directly in-channel                  | ✅     |\n| Reduced context switching                   | Keep actions, logs, and discussion together — less switching between terminal and chat      | ✅     |\n| Role-based access control                   | Restrict destructive commands (`/shell`, `/git`, worktree ops) to specific Discord roles    | ✅     |\n| Non-developer friendly                      | PMs, QA, and stakeholders can trigger checks and view results without repo access          | ✅     |\n| Automatable touchpoint                      | Integrate with CI/webhooks to triage issues and run fixes from chat                        | ✅     |\n| Local hosting \u0026 security                    | Keep keys and code on your infra while exposing a controlled interface through Discord      | ✅     |\n| Audit trail \u0026 accountability                | Channel history provides an easy-to-search record of who ran what and when                 | ✅     |\n\n\u003c/kbd\u003e\n\n\u003c/div\u003e\n\n\u003cbr\u003e\n\n\n**Start Here If You Have These:**\n\u003ckbd\u003eDISCORD_TOKEN\u003c/kbd\u003e\n\u003ckbd\u003eAPPLICATION_ID\u003c/kbd\u003e\n\n- **[Quick Start](#pre)** \n- **[Command List 48 Commands](#Command-list)** \n\n**Tutorial If you dont know or have them follow these first then come back:**\n- **[How To Setup Discord Bot?](#setup)**\n\n---\n\n### Preview: \n\u003cimg width=\"350\" height=\"350\" alt=\"image\" src=\"https://github.com/user-attachments/assets/e8091420-d271-48a4-8e55-279f2093d3ae\" /\u003e\n\n\n\n\u003ch2 id=\"pre\"\u003eQuick Start\u003c/h2\u003e\n\n- **Install Deno Can Be Done Via [Denos Website](https://deno.com/) Or Commands Under:**\n```C\n# Linux/MacOS\ncurl -fsSL https://deno.land/install.sh | sh\n\n# Windows|Powershell\nirm https://deno.land/install.ps1 | iex\n```\n\n**Clone the project:**\n```\ngit clone https://github.com/zebbern/claude-code-discord.git\ncd claude-code-discord\n```\n**Install claude `If you dont have it` and login:**\n```\nnpm install -g @anthropic-ai/claude-code\nclaude /login\n```\n**Required environment variables**\n```\n# Linux\nexport DISCORD_TOKEN=\"your-discord-bot-token\"\nexport APPLICATION_ID=\"your-discord-app-id\"\n\n# Windows Terminal \nset DISCORD_TOKEN=your-discord-bot-token\nset APPLICATION_ID=your-discord-app-id\n\n# Windows Powershell\n$env:DISCORD_TOKEN = \"your-discord-bot-token\"\n$env:APPLICATION_ID = \"your-discord-app-id\"\n```\n**Now Run the discord Bot**\n\u003e If you get `not a git directory` just run \n\u003e \u003ckbd\u003egit add .\u003c/kbd\u003e\n```bash\n# Option 1: Just run the bot\ndeno run --allow-all index.ts\n\n# Option 2: Run the bot with extra terminal output (For Dev)\ndeno run --allow-all index.ts --watch\n\n# Option 3: Run the bot and get pings when claude is done\n./index.ts --category myproject --user-id Your_Discord_User_ID_Here\n\n# Can also be ran like this: \ndeno run --allow-all index.ts --category yourproject --user-id Your_Discord_User_ID_Here\n```\n**You can run without `--user-id Your_Discord_User_ID_Here` if you dont want to be notified when claude finishes**\n\u003cimg width=\"250\" height=\"250\" alt=\"image\" src=\"https://github.com/user-attachments/assets/2fea008b-76b7-48d8-9a87-8214cc7a24ad\" /\u003e\n\n\n\n\n\u003ch1 id=\"setup\"\u003eSetup Discord Bot\u003c/h1\u003e\n\n\u003ch2 id=\"1\"\u003e1. Create a Discord Application\u003c/h2\u003e\n\n\u003e [!Note]\n\u003e - Go to the [Discord Developer Portal](https://discord.com/developers/applications)\n\u003e - Click \u003ckbd\u003eNew Application\u003c/kbd\u003e\n\u003e - Give your application a name (e.g., \u003ckbd\u003eClaudeCode\u003c/kbd\u003e)\n\u003e - Click \u003ckbd\u003eCreate\u003c/kbd\u003e\n\u003e \u003cimg width=\"500\" height=\"500\" alt=\"app-create\" src=\"https://github.com/user-attachments/assets/ee8bdf4e-9bbf-4d01-8046-a182ca6d5da9\" /\u003e\n\n\u003ch2 id=\"2\"\u003e2. Copy Application ID (Needed For Config)\u003c/h2\u003e\n\n\u003e [!Note]\n\u003e - Go to the \u003ckbd\u003eGeneral Information\u003c/kbd\u003e → Copy \u003ckbd\u003eApplication ID\u003c/kbd\u003e section\n\u003e \u003cimg width=\"800\" height=\"500\" alt=\"APPLICATION_ID\" src=\"https://github.com/user-attachments/assets/3ad02111-0a9f-4f0f-8a77-d61841f6dd27\" /\u003e\n\n\u003ch2 id=\"3\"\u003e3. Create a Bot User\u003c/h2\u003e\n\n\u003e [!Note]\n\u003e - In your application, go to the \u003ckbd\u003eBot\u003c/kbd\u003e section in the left sidebar\n\u003e - Click \u003ckbd\u003eAdd Bot\u003c/kbd\u003e\n\u003e - Under \u003ckbd\u003eToken\u003c/kbd\u003e click \u003ckbd\u003eCopy\u003c/kbd\u003e to copy your bot token (keep this secure!)\n\u003e - Click \u003ckbd\u003eSave Changes\u003c/kbd\u003e\n\u003e \u003cimg width=\"800\" height=\"500\" alt=\"image\" src=\"https://github.com/user-attachments/assets/0621b5ed-c4b4-44e3-a3f6-fe678f6893c3\" /\u003e\n\n\n\n\u003ch2 id=\"4\"\u003e4. Invite the Bot to Your Server\u003c/h2\u003e\n\n\u003e [!Note]\n\u003e - Go to the \u003ckbd\u003eOAuth2\u003c/kbd\u003e → \u003ckbd\u003eURL Generator\u003c/kbd\u003e section\n\u003e - Under \u003ckbd\u003eScopes\u003c/kbd\u003e select:\n\u003e ```\n\u003e + | bot\n\u003e + | applications.commands\n\u003e ```\n\u003e - Under \u003ckbd\u003eBot Permissions\u003c/kbd\u003e select:\n\u003e ```\n\u003e + | Send Messages\n\u003e + | Use Slash Commands\n\u003e + | Read Message History\n\u003e + | Embed Links\n\u003e ```\n\u003e Copy the generated URL and open it in your browser\n\u003e Select your Discord server and authorize the bot\n\u003e \u003cimg width=\"800\" height=\"500\" alt=\"oauth2\" src=\"https://github.com/user-attachments/assets/3e1fe004-1ae5-4078-b1a4-882a11bc68cd\" /\u003e\n\u003e \u003cimg width=\"800\" height=\"500\" alt=\"botallowcommands\" src=\"https://github.com/user-attachments/assets/9cd92467-2f3d-4c03-abb0-9f10ec979a1b\" /\u003e\n\u003e \u003cimg width=\"800\" height=\"500\" alt=\"image\" src=\"https://github.com/user-attachments/assets/697f6f52-fe37-4885-b492-5d660f23596d\" /\u003e\n\n\n\n## Command List \n\u003e (48 Commands)\n\n### Core Claude (3)\n- `/claude`, `/continue`, `/claude-cancel`\n\n### Enhanced Claude (4) \n- `/claude-enhanced`, `/claude-models`, `/claude-sessions`, `/claude-context`\n\n### Development Tools (7)\n- `/claude-explain`, `/claude-debug`, `/claude-optimize`, `/claude-review`\n- `/claude-generate`, `/claude-refactor`, `/claude-learn`\n\n### New Features (3)\n- `/todos` - Task management with API rate limits\n- `/mcp` - Model Context Protocol servers  \n- `/agent` - 7 specialized AI agents\n\n### Settings (4)\n- `/settings` - Unified settings (NEW)\n- `/claude-settings`, `/output-settings`, `/quick-model`\n\n### Git Operations (6)\n- `/git`, `/worktree`, `/worktree-list`, `/worktree-remove`\n- `/worktree-bots`, `/worktree-kill`\n\n### Shell Management (4)\n- `/shell`, `/shell-input`, `/shell-list`, `/shell-kill`\n\n### System Monitoring (10)\n- `/system-info`, `/processes`, `/system-resources`, `/network-info`\n- `/disk-usage`, `/env-vars`, `/system-logs`, `/port-scan`\n- `/service-status`, `/uptime`\n\n### Utilities (4)\n- `/status`, `/pwd`, `/shutdown`, `/help`\n\n### Agent System (3)\n- `/agent` with 7 specialized agents:\n  - Code Reviewer, Software Architect, Debug Specialist\n  - Security Analyst, Performance Engineer, DevOps Engineer, General Assistant\n\n\n#### Thinking Mode Options ✨\n- `none` - Standard Claude responses\n- `think` - Step-by-step reasoning mode\n- `think-hard` - Deep analysis and reasoning\n- `ultrathink` - Maximum depth thinking for complex problems\n\n#### Operation Mode Options ✨\n- `normal` - Standard operation with user confirmation\n- `plan` - Planning mode without execution\n- `auto-accept` - Automatically apply suggested changes\n- `danger` - Unrestricted mode (high risk)\n\n#### `/todos` Command ✨\n- **Action types**: list, add, complete, generate, prioritize, rate-status\n- **Priority levels**: low, medium, high, critical  \n- **Rate limit awareness** - Supports Anthropic API tiers including `exceeds_200k_tokens`\n- **Token estimation** - Calculates estimated token usage\n- **Auto-generation** - Generate todos from code files\n\n#### `/mcp` Command ✨ \n- **MCP server management** - Model Context Protocol integration\n- **Server types**: local, http, websocket, ssh\n- **Actions**: list, add, remove, test, status\n- **Connection testing** - Verify MCP server connectivity\n\n#### `/agent` Command ✨\n- **Specialized AI agents** for different development tasks:\n  - Code Reviewer - Quality analysis and security\n  - Software Architect - System design and architecture  \n  - Debug Specialist - Bug analysis and troubleshooting\n  - Security Analyst - Vulnerability assessment\n  - Performance Engineer - Optimization and profiling\n  - DevOps Engineer - Deployment and infrastructure\n  - General Assistant - Multi-purpose development help\n- **Risk levels** - Low/Medium/High risk classification\n- **Session management** - Persistent agent conversations\n- **Context awareness** - Include system info and files\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fclaude-code-discord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebbern%2Fclaude-code-discord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fclaude-code-discord/lists"}