🔌

Drop-in OpenAI Replacement

Point Codex or any OpenAI SDK at GodeX — no code changes needed. Translates Responses API to Chat Completions transparently, with tool calling, streaming, and structured output adapted per provider.

🧭

Smart Feature Bridging

Every request is planned against the provider's real capabilities. Tools are mapped, output formats are adapted, and unsupported features are gracefully degraded with diagnostics — never silently dropped.

⚡

Streaming-Native Gateway

SSE streaming powered by a formal phase-based state machine. Token-by-token delivery with live snapshots, robust error recovery, and zero buffering — even when providers fail mid-stream.

🔗

Multi-Turn Sessions

Native previous_response_id support with fork-safe chains, cycle detection, and pluggable backends (memory or SQLite). Multi-turn conversations just work across any provider.

🔍

Built-in Observability

Every request is traced — provider calls, token usage, compatibility decisions, and errors. Async batched recording to SQLite with configurable payload capture.

📦

Single Binary, Zero Dependencies

Compile once, run anywhere. Docker image under 50MB, native binaries for 6 platforms, or install via npm. No Node.js, no Python, no runtime baggage.

Quick Start

bash

# Install — no Bun required at runtime
npm install -g @ahoo-wang/godex

# Create config interactively
godex init

# Start the gateway
godex serve

Point Codex CLI at your GodeX instance:

bash

export OPENAI_BASE_URL=http://localhost:5678/v1
export OPENAI_API_KEY=any-value
codex

Section

Description

Start Here

Getting Started

Overview, quick start, config, providers

Overview

Architecture

End-to-end request flow, core types

Architecture Overview

Bridge Kernel

Compatibility, request/response, tools, output

Compatibility

Responses Pipeline

Sync and streaming orchestration

Sync Pipeline

Provider Development

How to add a new LLM provider

Provider Spec

Session Management

Multi-turn conversation support

Session Stores

Trace System

Request tracing and observability

Trace System

Error Handling

Error hierarchy and propagation

Error Handling

CLI

Command-line interface reference

CLI

Deployment

Docker, native binary, CI/CD

Deployment

Onboarding

Audience-tailored guides

Contributor Guide

Key Files

File

Responsibility

Source

src/index.ts

Entry point — delegates to CLI

src/index.ts:1-5

src/server/server.ts

Bun HTTP server, route map

src/server/server.ts:21-51

src/responses/runtime.ts

Bridge runtime, pipeline wiring

src/responses/runtime.ts:19-41

src/bridge/request/request-builder.ts

Responses → Chat Completions

src/bridge/request/request-builder.ts:54-92

src/bridge/provider-spec/contract.ts

ProviderSpec and ProviderEdge types

src/bridge/provider-spec/contract.ts:54-94

src/providers/builtin.ts

Built-in provider registry

src/providers/builtin.ts:37-55

src/session/types.ts

Session store interface

src/session/types.ts:99-121

src/config/schema.ts

Configuration type definitions

src/config/schema.ts:62-71

src/error/godex-error.ts

Base error class hierarchy

src/error/godex-error.ts:2-35

Technology

Purpose

Version

Bun

Runtime, test runner, SQLite, binary compilation

>=1.2

TypeScript

Language (strict, ESNext, ESM)

Biome

Formatting and linting

^2.4

Commander.js

CLI framework

^15

LogTape

Structured logging

^2.1

SQLite

Sessions and trace storage

built-in

fetcher

HTTP client with SSE

^3.16

GodeXMake every model a Codex engine.

Drop-in OpenAI Replacement

Smart Feature Bridging

Streaming-Native Gateway

Multi-Turn Sessions

Built-in Observability

Single Binary, Zero Dependencies

How It Works

Quick Start

Documentation Map

Key Files

Tech Stack

GodeXMake every model a Codex engine.

Drop-in OpenAI Replacement

Smart Feature Bridging

Streaming-Native Gateway

Multi-Turn Sessions

Built-in Observability

Single Binary, Zero Dependencies

How It Works ​

Quick Start ​

Documentation Map ​

Key Files ​

Tech Stack ​

How It Works

Quick Start

Documentation Map

Key Files

Tech Stack