opencodex

(★ 11,640)

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

File Explorer

Showing a partial file list — download the zip above to see everything.

  • .coderabbit.yaml
  • .gitattributes
  • .gitignore
  • .npmignore
  • AGENTS.md
  • AGENTS_INSTALL.md
  • bun.lock
  • bunfig.toml
  • CONTRIBUTING.md
  • LICENSE
  • MAINTAINERS.md
  • README.md
  • SECURITY.md

# Installation Guide

node
Prerequisites

Setup Steps

npm install -g @bitkyc08/opencodex

Install opencodex globally via npm.

ocx start

Start the proxy and dashboard on localhost.

ocx init

Interactively configure settings and wire Codex.

Key Commands

ocx start

Start the proxy server and dashboard.

ocx service

Run the proxy as a background service.

ocx init

Run interactive setup utility for initial configuration.

ocx gui

Re-open the web dashboard interface.

ocx status

Report the running state and connection status.

ocx stop

Stop the running proxy and restore original configuration.

Requires Node.js 18+; the Bun runtime is bundled automatically.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Showing a partial file list.

Release Timeline

Actively Maintained

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

bun install

View Details ▼

Install JavaScript dependencies for a project from `package.json`.

bun {{[i|install]}}

Install all dependencies listed in `package.json`:

bun {{[i|install]}} {{package_name}}@{{version}}

Install a single package (this is an alias for `bun add`):

bun {{[i|install]}} {{[-g|--global]}} {{package_name}}

Install a package globally:

🔍

bun run

View Details ▼

Execute a JavaScript/TypeScript file, or a script from `package.json`.

bun run {{script_name}}

Run a script defined in `package.json`:

bun run {{path/to/file.ts}}

Run a JavaScript or TypeScript file directly:

bun run --watch {{path/to/file.ts}}

Run a file in "watch" mode (restarts automatically when the file changes):

🔍

bun

View Details ▼

JavaScript runtime and toolkit.
Includes a bundler, a test runner, and a package manager.

bun init

Create a new Bun project in the current directory:

bun run {{path/to/file|script_name}}

Run a JavaScript file or a `package.json` script:

bun test

Run unit tests:

🔍

codex

View Details ▼

Natural language code assistant for the terminal, powered by OpenAI.
Reads and edits files in your current directory to fulfill requests.

codex

Start an interactive Codex session in the current directory:

codex "{{prompt}}"

Run a single Codex command using a prompt:

codex --sandbox workspace-write "{{prompt}}"

Run a prompt allowing Codex to edit files in the workspace:

🔍

git clone

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

npm install

View Details ▼

Install Node packages.

npm {{[i|install]}}

Install dependencies listed in `package.json`:

npm {{[i|install]}} {{package_name}}@{{version}}

Download a specific version of a package and add it to the list of dependencies in `package.json`:

npm {{[i|install]}} {{package_name}} {{[-D|--save-dev]}}

Download the latest version of a package and add it to the list of dev dependencies in `package.json`:

🔍

npm uninstall

View Details ▼

Remove a package.

npm {{[r|uninstall]}} {{package_name}}

Remove a package from the current project:

npm {{[r|uninstall]}} {{package_name}} {{[-g|--global]}}

Remove a package globally:

npm {{[r|uninstall]}} {{package_name1 package_name2 ...}}

Remove multiple packages at once:

// repository documentation