Codex — Enterprise AI Engineering Platform

Production-grade autonomous AI coding assistant with multi-agent orchestration, WebXR visualization, and zero-trust sandboxing.

🇺🇸 English | 🇯🇵 日本語 | 📖 Docs | 🚀 Quick Start | 🔖 Releases

---

🇺🇸 English

What is Codex?

Codex is a next-generation AI engineering platform forked from OpenAI/codex and dramatically extended with enterprise features. It transforms AI from a simple code assistant into a self-organizing, multi-agent development environment capable of autonomously designing, coding, reviewing, and testing software — with full VR/AR visualization and MCP ecosystem integration.

Built in Rust 2024 for maximum performance and memory safety. Ships with a Next.js 14 GUI (port 1919), WebSocket CLI bridge, immersive 3D Git visualization (Git4D), and a pluggable MCP server/client ecosystem.

---

Why Codex? — The Killer Features

Dimension	What We Ship
🤖 Multi-Agent	Planner → Assigner → Executor (parallel) → Aggregator pipeline
🔒 Security	Zero-trust sandbox: Win32 Job Objects / Linux Landlock / macOS Seatbelt
⚡ Performance	Rust 2024 · 6-core sccache build · CUDA 3.7x GPU search acceleration
🔌 MCP Dual-Mode	Codex IS a tool AND uses tools — full MCP server + client
🎮 VR/AR Git	Three.js + WebXR · Meta Quest 2/3 hand tracking · Cyberpunk shaders
🔬 Research	DuckDuckGo + Gemini + Brave multi-source deep research engine
🛠 Slash Commands	/VRChat · /Blender-CAD · /Yukkuri-Movie · /DeepResearch
📡 New in v2.17	MCP OAuth, network proxy, disk-cached startup, fine-grained approvals

---

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│                       User Interface Layer                       │
│  ┌──────────────┐  ┌──────────────┐  ┌───────────────────────┐  │
│  │  TUI (Ratatui)│  │ Next.js GUI  │  │ MCP Client / VSCode   │  │
│  │  Slash cmds  │  │ Port 1919    │  │ Extension             │  │
│  └──────┬───────┘  └──────┬───────┘  └─────────┬─────────────┘  │
│         │ stdin/stdout    │ WebSocket           │ JSON-RPC       │
└─────────┼─────────────────┼─────────────────────┼───────────────┘
          ▼                 ▼                     ▼
┌─────────────────────────────────────────────────────────────────┐
│                       Core Runtime (Rust)                        │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────────────────┐  │
│  │ App Server  │  │ Core Engine  │  │  MCP Server            │  │
│  │ Port 8787   │  │ (codex-core) │  │  (codex-mcp-server)    │  │
│  └──────┬──────┘  └──────┬───────┘  └─────────┬──────────────┘  │
│         │                │                     │                 │
│  ┌──────▼──────────────────────────────────────▼──────────────┐  │
│  │            Multi-Agent Orchestration Runtime                │  │
│  │  Planner → Assigner → Executor (parallel) → Aggregator     │  │
│  └──────────────────────────┬────────────────────────────────┘  │
└─────────────────────────────┼───────────────────────────────────┘
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                       Execution Layer                            │
│  ┌───────────────┐  ┌──────────────┐  ┌───────────────────────┐  │
│  │ Sandboxed Exec │  │ Tool Routing │  │ OpenAI Backend Client │  │
│  │ (platform ACL) │  │ (shell/file) │  │ (SSE streaming)       │  │
│  └───────────────┘  └──────────────┘  └───────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

---

Key Features

🤖 Multi-Agent Orchestration (zapabob Extension)

codex delegate-parallel --agents backend,qa,frontend --task "Implement auth module"

• Planner: Decomposes complex tasks into granular subtasks
• Assigner: Routes to specialized sub-agents (backend / QA / security / frontend)
• Executor: Runs agents in parallel using isolated Git worktrees
• Aggregator: Merges results with semantic conflict detection

Benchmark: 2.59× average speedup over sequential execution across test cases.

🔒 Zero-Trust Security Sandbox

Three-tier, platform-native process isolation — no userspace hacks:

Platform	Technology	Scope
Windows	Win32 Job Objects + restricted token ACLs	Kernel-level
Linux	Landlock LSM + seccomp-bpf syscall filtering	Kernel-level
macOS	Seatbelt (sandbox-exec) profiles	Kernel-level

Three modes: read-only (default) · workspace-write · danger-full-access

🔌 MCP Dual-Mode: Client AND Server

Codex is unique in operating as both an MCP consumer and provider:

• As a Client: Connects to external MCP servers (filesystem, git, browser, etc.)
• As a Server: Exposes its own coding capabilities to Claude, Cursor, and other AI agents
• New in v2.17.0: OAuth callback URL configuration + network proxy support

🔬 Deep Research Engine

Multi-source intelligent research — not just web search:

• Sources: DuckDuckGo + Gemini + Brave Search APIs in parallel
• Verification: Citation tracking, cross-source fact checking
• Depth: Recursive exploration, academic paper synthesis (arXiv, Scholar)
• Output: Structured reports with confidence scores

🎮 VR/AR Git Visualization (Git4D)

Experience your repository in immersive 3D:

• Three.js + WebXR: Commit graph rendered in 4D space-time
• Meta Quest 2/3: Full hand tracking support
• Cyberpunk aesthetics: Custom GLSL shader effects
• Launch via /VRChat slash command from TUI

🛠️ Domain Slash Commands (TUI)

Command	Specialized Agent	Capabilities
/VRChat	vrchat-dev	Unity C#, Udon, Modular Avatar, liltoon
/Blender-CAD	blender-cad	STEP/IGES import, Geometry Nodes, RTX rendering
/Yukkuri-Movie	yukkuri-movie	YMM4 automation, VOICEVOX TTS, video pipeline
/DeepResearch	web-search-deepresearch	Multi-source parallel research

---

What's New in v2.17.0

✨ Upstream OpenAI Sync (163 commits)

• MCP OAuth callback URL — configurable OAuth flow for MCP authentication
• Network proxy support — permissions.network.proxy configuration
• Fine-grained rejection policies — per-operation approval enforcement
• Configurable agent spawn depth — prevent unbounded recursion
• Disk-backed apps tool cache — faster cold start (<2s)
• Security: CVE-2026-24842 (pnpm) patched

🛠️ zapabob Extensions Preserved & Enhanced

• GUI version unified: 2.14.1 → 2.17.0 (single source of truth)
• 0 Rust compiler warnings — clean MILSPEC-grade build
• Playwright E2E: 20/24 tests passing (chromium)
• VRChat / Blender-CAD / YMM4 slash commands
• Enhanced YAML-defined agent skill system
• Model catalog integration: ModelsManager + ThreadManager

---

Quick Start

Prerequisites

# Required
rustup toolchain install 1.93.0
export OPENAI_API_KEY="sk-..."

# Optional (for GUI)
node --version  # >= 20
npm install -g pnpm

Run CLI (Interactive TUI)

cd codex-rs
cargo run --bin codex

Run GUI (Next.js + Rust Backend)

# Terminal 1: Start WebSocket backend
cd codex-rs
cargo run --bin codex-gui          # Runs on :8787

# Terminal 2: Start Next.js frontend
cd gui
npm install && npm run dev          # Runs on http://localhost:1919

Autonomous Agent Mode

# Single agent execution
codex exec "Add comprehensive unit tests for the auth module"

# Multi-agent parallel delegation
codex delegate-parallel \
  --agents "code-reviewer,test-gen,sec-audit" \
  --task "Review PR #42 — all dimensions"

Build from Source

# Windows — fast incremental build (6-core, sccache)
cd codex-rs
.\ultra-fast-build-install.ps1

# Linux / macOS
cd codex-rs
cargo install --path cli

---

Technology Stack

Layer	Technology	Version
Core Language	Rust	1.93.0 (2024 edition)
Async Runtime	Tokio	1.42+
TUI Framework	Ratatui	latest
AI Protocol	OpenAI Responses API	v2
Tool Protocol	MCP (Model Context Protocol)	1.0
Frontend	Next.js + React	14 + latest
UI Components	MUI (Material UI)	7
3D Graphics	Three.js + @react-three	0.159+
WebXR	@react-three/xr	6.2
Testing	cargo-nextest + Playwright	latest
Build	Cargo + Bazel + sccache	workspace
GPU	CUDA	12.0+ (RTX 3080+)

---

Repository Structure

codex-main/
├── codex-rs/              # Rust workspace (69 crates)
│   ├── cli/               # Binary entry point
│   ├── core/              # Orchestration engine + tool router
│   ├── tui/               # Terminal UI (Ratatui + slash commands)
│   ├── app-server/        # WebSocket bridge for GUI (port 8787)
│   ├── mcp-server/        # MCP server — expose Codex as a tool
│   ├── deep-research/     # Multi-source research engine
│   ├── supervisor/        # Multi-agent lifecycle manager
│   └── gui/               # Rust GUI backend
├── gui/                   # Next.js 14 frontend (port 1919)
│   ├── src/app/           # 21 pages (dashboard, VR, tasks, chat…)
│   ├── src/components/    # 60+ React components
│   └── tests/             # Playwright E2E tests
├── codex-cli/             # Node.js CLI wrapper
├── .codex/agents/         # YAML agent definitions (skills)
├── .cursor/skills/        # Cursor IDE skill definitions
├── docs/                  # Technical documentation
└── _docs/                 # Implementation logs (per-release)

---

Performance Benchmarks

Metric	Value	Notes
Incremental build	~3 min	6-core, sccache
Cold start	<2 s	Disk-cached apps tool
Agent spawn latency	<100 ms	Per sub-agent
CUDA search acceleration	3.7×	vs. CPU baseline (RTX 3080)
Multi-agent speedup	2.59×	vs. sequential execution
GUI build (21 pages)	~3.5 min	Vite + Next.js

---

CI/CD

# GitHub Actions matrix:
platforms:
  - linux-x64
  - macos-arm64
  - windows-x64
checks:
  - clippy (0 warnings enforced)
  - rustfmt
  - cargo-nextest
  - cargo-deny
  - cargo audit
  - pnpm audit
frontend:
  - Playwright E2E (chromium, 20/24 passing)

---

🇯🇵 日本語

Codexとは

CodexはOpenAI/codexをフォークし、エンタープライズ向け機能を大幅に拡張した次世代AIエンジニアリングプラットフォームです。AIを単なるコード補完ツールから、設計・実装・レビュー・テストを自律的に行うマルチエージェント開発環境へと進化させます。

zapabob独自機能 — 他にはない差別化ポイント

🔌 MCP デュアルモード（クライアント＆サーバー）

CodexはMCPを使うだけでなく、提供する側にもなれます：

• クライアントとして：外部MCPサーバー（ファイルシステム、Git、ブラウザ等）に接続
• サーバーとして：Claude・Cursor等の他AIエージェントへコーディング能力を提供
• v2.17.0新機能：OAuth認証コールバックURL対応 + ネットワークプロキシ設定

🤖 マルチエージェントオーケストレーション

codex delegate-parallel --agents backend,qa,frontend --task "認証モジュール実装"

フェーズ	役割
Planner	複雑なタスクをサブタスクに分解
Assigner	バックエンド/QA/セキュリティ/フロントエンドへ振り分け
Executor	Git worktreeを使い並列実行（2.59×高速化）
Aggregator	意味的差分検出による結果マージ

🎮 WebXR Gitビジュアライゼーション（Git4D）

• Three.js + WebXR でリポジトリを3D/4D空間で体験
• Meta Quest 2/3 ハンドトラッキング対応
• サイバーパンク調 GLSLシェーダーエフェクト

🔬 ディープリサーチエンジン

• DuckDuckGo + Gemini + Brave Search API を並列実行
• 引用追跡・クロスソース事実確認
• 学術論文（arXiv, Scholar）の自動統合

🛡️ ゼロトラストサンドボックス（カーネルレベル）

プラットフォーム	技術
Windows	Win32 Job Objects + 制限トークンACL
Linux	Landlock LSM + seccomp-bpf
macOS	Seatbelt (sandbox-exec)

バージョン v2.17.0 の変更点

公式OpenAIからの取り込み（163コミット）:

• MCP OAuth コールバックURL設定対応
• ネットワークプロキシ設定（permissions.network.proxy）
• 拒否承認ポリシーの細粒度化
• エージェント生成深度の設定可能化
• ディスクキャッシュによる起動高速化（<2秒）
• セキュリティパッチ: CVE-2026-24842 (pnpm)

zapabob独自機能（維持・強化）:

• GUIバージョン統一: 2.14.1 → 2.17.0
• Rustコンパイラ警告ゼロ（MILSPEC準拠クリーンビルド）
• Playwright E2Eテスト: 20/24 パス（Chromium）
• TUIスラッシュコマンド強化（/VRChat, /Blender-CAD, /Yukkuri-Movie）
• YAML定義エージェントスキルシステム強化
• ModelCatalog統合（ModelsManager + ThreadManager）

セットアップ

# 環境変数設定
export OPENAI_API_KEY="sk-..."

# CLIのみ（最小構成）
cd codex-rs && cargo run --bin codex

# GUI込み（フル構成）
# ターミナル1: WebSocketバックエンド
cd codex-rs && cargo run --bin codex-gui

# ターミナル2: Next.jsフロントエンド
cd gui && npm install && npm run dev    # http://localhost:1919

サンドボックスモード

モード	説明	推奨用途
read-only	ファイル読み取りのみ（デフォルト）	安全な分析・レビュー
workspace-write	ワークスペース内書き込み	通常開発作業
danger-full-access	フルアクセス（明示的許可必要）	統合テスト

---

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

• Issues: GitHub Issues
• Security: See SECURITY.md
• Discussions: GitHub Discussions

License

Apache 2.0 — See LICENSE for details.

---

Built with ❤️ by @zapabob | Powered by OpenAI Codex Platform

⬆ Back to top

🔗 https://github.com/zapabob/codex