⚡ VibeCord

A production-grade, local-first MCP server and command-line engine that gives AI coding harnesses (Antigravity, Claude Code, Codex, Hermes, OpenClaw, Cursor, Windsurf) comprehensive Discord control capabilities.

Product Vision

AI coding harnesses excel at writing code, but modern development workflows and communities live in Discord. VibeCord (vibecord) bridges this gap: a single, local-first engine providing both an interactive terminal CLI and a standard Model Context Protocol (MCP) server.

One installation. One interactive setup. Zero hosted SaaS dependencies.

┌─────────────────────────────────────────────────────────────────────────────────┐
│                           AI CODING HARNESSES                                   │
│  [Antigravity]  [Claude Code]  [Codex CLI]  [Hermes]  [OpenClaw]  [Cursor] ... │
└────────────────────────────────────────┬────────────────────────────────────────┘
                                         │ JSON-RPC (stdio) / CLI
                                         ▼
┌─────────────────────────────────────────────────────────────────────────────────┐
│                    UNIVERSAL DISCORD BRIDGE ENGINE                              │
│                                                                                 │
│   ┌──────────────────────────┐                  ┌───────────────────────────┐   │
│   │   Terminal UX & CLI      │                  │   MCP Stdio Protocol      │   │
│   │  (setup, doctor, status) │                  │  (45 Universal Tools)     │   │
│   └────────────┬─────────────┘                  └─────────────┬─────────────┘   │
│                │                                              │                 │
│                ▼                                              ▼                 │
│   ┌─────────────────────────────────────────────────────────────────────────┐   │
│   │                      Core Engine & Safety Guard                         │   │
│   │  • Permission Verification      • Secret Redaction & 0600 Storage       │   │
│   │  • Rate-Limit Exponential Backoff • Read-Only Mode Switch               │   │
│   │  • Declarative Server Blueprints • Destructive Action Confirmations     │   │
│   └────────────────────────────────────┬────────────────────────────────────┘   │
│                                        │                                        │
│                                        ▼                                        │
│                        Discord API v10 (REST & Gateway)                         │
└────────────────────────────────────────┬────────────────────────────────────────┘
                                         │ HTTPS / WSS
                                         ▼
                                   DISCORD CLOUD

Related MCP server: Crow

Key Features

• ⚡ Universal Harness Compatibility: Direct adapters for Google DeepMind Antigravity, Anthropic Claude Code, OpenAI Codex, Hermes, OpenClaw, Cursor, and Claude Desktop.

• 🛡️ 100% Local-First & Secure: Zero telemetry, zero external servers. Tokens stored exclusively in local config files with POSIX mode 0600 (directory 0700). Automatic masking for all token diagnostics (MTE4...3XYZ).

• 🎛️ 45 Production Tools: Complete coverage across Servers, Channels, Categories, Roles, Permission Overwrites, Messages, Rich Embeds, Link Buttons, Threads, Forum Posts, Webhooks, Moderation (Timeout, Kick, Ban), and Audit Logs.

• 🏗️ Declarative Server Operations: Built-in architecture blueprints (developer_community, saas_support, gaming_guild, minimal). Audit servers for security misconfigurations, preview diffs before mutation, apply with topological dependency ordering, and verify compliance against drift.

• 🎨 Elite Terminal UX: Aesthetic near-black surfaces with restrained lime-green accents (#a3e635), Unicode tables, real-time diagnostic doctor, and full --json non-interactive headless support.

• 🛡️ Rate-Limit & Failure Resilience: Automatic retry handling for HTTP 429 rate limit buckets with jitter and exponential backoff.

Quick Start (60 Seconds)

1. Installation

Install globally via npm:

npm install -g vibecord

Or run directly from source:

git clone https://github.com/ItzPhantomm/VibeCord.git
cd vibecord
npm install
npm run build
npm link

2. Setup Bot & Credentials

Launch the interactive configuration wizard:

vibecord setup

The wizard will:

1. Guide you through creating a bot in the Discord Developer Portal.

2. Validate your bot token against the live Discord API.

3. Generate minimal or administrative OAuth2 invite URLs for your server.

4. Auto-detect installed AI coding harnesses and register the MCP server.

Non-Interactive / Headless Setup:

vibecord setup --non-interactive --token "YOUR_DISCORD_BOT_TOKEN" --guild-id "123456789012345678" --harness antigravity

3. Verify Health with Doctor

Run diagnostics to verify runtime, token validity, permissions, network latency, and harness readiness:

vibecord doctor

Output:

 ⚡ DISCORD BRIDGE v1.0.0
 Universal Discord control layer for AI coding harnesses
 ────────────────────────────────────────────────────────────

 System Health Diagnostics & Verification

┌────────────┬──────────────────────────┬────────┬──────────────────────────────────────────────────────────────────────┐
│ Category   │ Check                    │ Status │ Details                                                              │
├────────────┼──────────────────────────┼────────┼──────────────────────────────────────────────────────────────────────┤
│ Runtime    │ Node.js Version          │ ✔ PASS │ v22.23.1 (Supported, >= v18)                                         │
│ Config     │ Config File              │ ✔ PASS │ /root/.config/vibecord/config.json                              │
│ Config     │ File Permissions         │ ✔ PASS │ 0600 (Owner-only read/write)                                         │
│ Discord API│ Authentication           │ ✔ PASS │ Authenticated as MyBot#0001 (ID: 1234567890)                         │
│ Discord API│ REST Latency             │ ✔ PASS │ 64ms roundtrip                                                       │
│ Discord API│ Guild Access             │ ✔ PASS │ Member of 2 server(s)                                                │
│ AI Harness │ Antigravity / Gemini CLI │ ✔ PASS │ Detected and registered in /root/.gemini/antigravity-cli/mcp/discord │
│ AI Harness │ Claude Code              │ ✔ PASS │ Detected and registered in /root/.claude.json                        │
└────────────┴──────────────────────────┴────────┴──────────────────────────────────────────────────────────────────────┘

   ALL CHECKS PASSED   Discord Bridge is healthy and fully operational.

AI Harness Integration

VibeCord automatically detects and integrates with your AI coding agents:

1. Antigravity / Gemini CLI

Automatically generates tool JSON schemas and guidance into ~/.gemini/antigravity-cli/mcp/discord/:

vibecord connect --harness antigravity

2. Claude Code

Automatically updates ~/.claude.json:

vibecord connect --harness claude-code

3. Codex CLI

Automatically updates ~/.codex/config.json:

vibecord connect --harness codex

4. Cursor / Windsurf / Claude Desktop

View copy-paste JSON configurations for manual setup:

vibecord connect --manual

Declarative Server Blueprints & Operations

Manage entire Discord server configurations using declarative JSON templates.

1. Design a Server Blueprint

Generate production-ready architectures (developer_community, saas_support, gaming_guild, minimal):

vibecord plan design --template developer_community --out blueprint.json

2. Audit Security Posture

Scan for dangerous @everyone permissions, excessive administrator roles, and missing verification:

vibecord plan audit --guild-id <SERVER_ID>

3. Preview Proposed Changes

Compare your desired blueprint against live server state before applying:

vibecord plan preview blueprint.json --guild-id <SERVER_ID>

4. Apply Blueprint Safely

Executes mutations in topological order (Roles → Categories → Channels → Permissions) with rate-limit protection:

vibecord plan apply blueprint.json --guild-id <SERVER_ID> --yes

5. Verify & Detect Drift

Confirm 100% compliance between live server state and your version-controlled blueprint:

vibecord plan verify blueprint.json --guild-id <SERVER_ID>

6. Export Live Server Backup

Export current live server architecture into reusable JSON:

vibecord plan backup --guild-id <SERVER_ID> --out server-backup.json

Tool Reference Catalog (45 Tools)

Security Model & Guidelines

1. Local-First Secret Storage: Credentials reside strictly in ~/.config/vibecord/config.json. The configuration engine enforces POSIX mode 0600 on the file and 0700 on the parent directory.

2. Zero Log Leakage: All diagnostic outputs, CLI errors, and log entries mask bot tokens (MTE4...3XYZ).

3. Read-Only Safety Switch: Want to let AI agents inspect servers without risking mutations? Set "readOnly": true in config.json or pass --read-only during setup. All write endpoints immediately reject with OPERATION_ABORTED.

4. Explicit Confirmations: Destructive operations (delete_channel, delete_role, kick_member, ban_member, apply_server_plan) enforce explicit confirmation parameters (confirm: true) to prevent accidental AI agent catastrophes.

Testing & Quality Assurance

VibeCord includes a comprehensive Vitest test suite with realistic mocks. No live credentials or network access are required for test runs:

npm test

Test coverage includes:

• Security permissions & 0600 file protection

• Token redaction and deep object masking

• Discord permission bitfield calculation & preset resolution

• REST rate-limiting retries with exponential backoff

• Tool registry parameter validation & destructive confirmation guards

• Declarative blueprint generation, diffing, and drift detection

• AI harness adapter configurations and schema generation

License

MIT License. VibeCord is free and open-source software.