Codexcord

Discord bridge for Codex. Each forum thread maps to:

• one stable git branch/worktree
• one Codex app-server instance
• one Codex thread ID

Now CLI-first, supports global bot tokens + per-project multi-target config.

Requirements

• bun installed
• codex CLI installed and authenticated
• Discord bot token(s)
• bot(s) added to your server with forum/thread read+write perms

CLI

codexcord run
codexcord run --project /path/to/repo
codexcord run --target support-us --target support-eu
codexcord setup --forum-channel-id 123456789012345678 --token <discord_token>
codexcord set-token <discord_token>
codexcord set-token <discord_token> --bot main

Global Config (tokens)

Stored at:

• macOS/Linux: ~/.config/codexcord/config.json
• Windows: %APPDATA%/codexcord/config.json

Commands:

codexcord config global set-token <discord_token>
codexcord config global set-token <discord_token> --bot main
codexcord config global list
codexcord config global remove-bot --bot main

Project Config (per repo)

Default file: .codexcord.json

Create + manage:

codexcord config project init
codexcord config project add-target --forum-channel-id 1234567890
codexcord config project add-target --name support-us --discord-bot main --forum-channel-id 1234567890
codexcord config project add-target --name support-eu --discord-bot main --forum-channel-id 2234567890
codexcord config project set-token <discord_token> --target support-us
codexcord config project show

Example:

{
  "version": 1,
  "repoRoot": ".",
  "targets": [
    {
      "name": "support-us",
      "discordBot": "main",
      "forumChannelId": "123456789012345678"
    },
    {
      "name": "support-eu",
      "discordBot": "main",
      "forumChannelId": "223456789012345678",
      "enableMessageContentIntent": true
    }
  ]
}

Env Mode (backward compatible)

If both are set, CLI runs env mode (no project/global files needed):

• DISCORD_BOT_TOKEN
• DISCORD_FORUM_CHANNEL_ID

Optional overrides still work:

• DISCORD_ENABLE_MESSAGE_CONTENT_INTENT
• DISCORD_MAX_REPLY_CHARS
• CDX_REPO_ROOT
• CDX_WORKTREE_ROOT
• CDX_BRANCH_PREFIX
• CDX_COMMAND
• CDX_MODEL
• CDX_APPROVAL_POLICY
• CDX_SANDBOX
• CDX_EPHEMERAL_THREAD
• CDX_BASE_INSTRUCTIONS
• CDX_DEVELOPER_INSTRUCTIONS