# Codex Bridge

Desktop application and background service connecting MCP clients to local directories, terminal tools, and coding agents. Designed for running automated tasks with manual approval.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 281
- Author: Fanch-hui
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Fanch-hui/codex-bridge
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/codex-bridge

## What it does

Codex Bridge combines a Swift desktop interface with a local daemon on macOS, Windows, and Linux. The server exposes a Direct Workspace to MCP clients such as Claude Code, letting them inspect local project files and apply code patches. Directory permissions and task history remain strictly on the host system.

When basic workspace tools fall short, the bridge delegates work to external engines like Codex or OpenCode. Sensitive actions require explicit local approval through pop-up cards. Configuration and active sessions stay local, and credentials go directly into the operating system keychain.

Windows environments require WebView2 Runtime before the interface launches. On macOS 14+, the build uses ad-hoc signing, meaning Gatekeeper stops execution until you permit it inside privacy settings.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- grant MCP clients controlled access to local source code
- execute shell commands and file patches with interactive approval
- route programming workloads to Codex or OpenCode agents
- manage tool tokens and project folders inside local storage

## Example prompts
- Check git status in the registered project folder using Codex Bridge
- Apply the patch to update dependencies in the workspace
- Run the project test suite and return the terminal log

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md