cli-discord-bridge

Name: cli-discord-bridge
Author: who96

Verified

CLI Discord bridge with Codex-first runtime and legacy Claude compatibility.

125stars

10forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/who96/cli-discord-bridge

Getting Started

Guides for using cli tools skills like cli-discord-bridge.

Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
SkillsLLM Features Guide
Voting, bookmarks, comments, comparison pages, and security scanning explained.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.

Security ReportVerified

Last scanned: 5/30/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-30T16:23:40.864Z",
  "npmAuditRan": true,
  "pipAuditRan": false
}

README.md

Frequently Asked Questions

What is cli-discord-bridge?

cli-discord-bridge is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by who96. CLI Discord bridge with Codex-first runtime and legacy Claude compatibility. It has 125 GitHub stars.

Is cli-discord-bridge safe to use?

Yes. cli-discord-bridge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install cli-discord-bridge?

Clone the repository with "git clone https://github.com/who96/cli-discord-bridge" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is cli-discord-bridge written in?

cli-discord-bridge is primarily written in Python. It is open-source under who96 on GitHub, so you can review or fork the full source.

Are there alternatives to cli-discord-bridge?

Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cli-discord-bridge against similar tools.

LLM Engineer for Beginners

Ship LLM features to production - prompts, RAG, structured outputs, evaluation

39 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

227,972

Popular in CLI Tools

Top skills in this category by stars

ui-ux-pro-max-skill

by nextlevelbuilder

An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms

103,635

skill-security-scan Claudeman

CLI Discord Bridge

Single-file Discord bridge for Codex CLI operation.

The actively maintained runtime targets Codex: one Discord channel connects to one Codex CLI process. Legacy artifacts remain only for rollback and command continuity.

Command surface remains compatible with earlier bridge flows: /new /status /connect /handoff /help.

Deployment Topology

Single process, single channel, single vendor (Codex)
One process listens to exactly one CHANNEL_ID
Multi-channel or multi-vendor HA is done by duplicating processes, not by mixing routes in one process

Runtime Flow

Discord message -> bridge.py -> codex exec/resume --json -> parse JSON events -> Discord reply

Bridge state:

State dir: ~/.cli-discord-bridge/
Session file: ~/.cli-discord-bridge/session.json
- Primary key: thread_id
- Backward-compatible read: legacy session_id
Handoff dir: ~/.cli-discord-bridge/handoffs/

Codex Session Protocol

New thread:
- codex exec --json --skip-git-repo-check [--dangerously-bypass-approvals-and-sandbox] [-m MODEL] "<prompt>"
Resume thread:
- codex exec resume --json --skip-git-repo-check [--dangerously-bypass-approvals-and-sandbox] [-m MODEL] <thread_id> "<prompt>"
Parser rules:
- Parse JSON lines only, ignore non-JSON noise
- Use thread.started.thread_id as authoritative thread ID
- Aggregate item.completed.item.type=="agent_message" text as reply body

/connect safety:

Explicit /connect <thread_id> is strict.
If resume returns a different thread.started.thread_id, bridge treats it as failure and blocks auto-fallback.

Implicit fallback:

In non-explicit mode, resume failure may switch to a new thread and update local state.

Environment Variables

Variable	Required	Default	Description
`DISCORD_TOKEN`	Yes	—	Discord bot token
`CHANNEL_ID`	Yes	—	Discord channel ID
`CODEX_BIN`	No	`codex`	Codex CLI binary path
`CODEX_MODEL`	No	empty	Optional model override
`CODEX_TIMEOUT`	No	`300`	Max seconds per Codex call
`CODEX_CWD`	No	`$HOME`	Working directory for Codex call
`CODEX_FULL_ACCESS`	No	`0`	`1` enables `--dangerously-bypass-approvals-and-sandbox`
`SELFTEST_ON_START`	No	`0`	`1` runs startup selftest

Compatibility fallback (for smooth migration):

CLAUDE_CWD can still be used if CODEX_CWD is not set
CLAUDE_TIMEOUT can still be used if CODEX_TIMEOUT is not set

Commands

Command	Behavior
`/new`	Clear current thread; next message creates a new thread
`/status`	Show current thread, cwd, timeout, backend
`/connect [thread-id]`	Bind explicit thread (no arg = reset)
`/handoff`	Summarize old thread -> coldstart new thread; rollback old thread if new bootstrap fails
`/help`	Show command help

Local Run

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

DISCORD_TOKEN="xxx" \
CHANNEL_ID="1234567890" \
CODEX_FULL_ACCESS="1" \
.venv/bin/python3 bridge.py

LaunchAgent (CLI)

Legacy rollback example:

com.claude.discord-bridge.plist.example (legacy)

Use the active CLI bridge example:

com.cli.discord-bridge.plist.example

Install example:

cp com.cli.discord-bridge.plist.example ~/Library/LaunchAgents/com.cli.discord-bridge.plist
# edit token/channel/paths
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.cli.discord-bridge.plist

Stop:

launchctl bootout gui/$(id -u)/com.cli.discord-bridge

Logs:

tail -f ~/.cli-discord-bridge/bridge.log
tail -f ~/.cli-discord-bridge/bridge.err.log

Gray Release and Rollback

Recommended migration sequence:

Start com.cli.discord-bridge in a new Discord channel.
Keep the legacy rollback service running in parallel for observation.
Observe 24h for stuck process, leaks, thread loss, and command compatibility.
Switch OpenClaw DR entry to the new CLI bridge channel.
If needed, rollback by stopping com.cli.discord-bridge and continuing with legacy service.

Notes

This project does not implement dynamic multi-vendor switching in one process.
If you need more HA lanes, copy service instances with different CHANNEL_ID and state dirs.