ore, n. (Mining) A native metal or its compound with the rock in
which it occurs, after it has been picked over to throw out what is worthless.
— Webster's Revised Unabridged Dictionary, 1913
A coding agent for the terminal. Ore is a fork of OpenAI Codex with no telemetry, and it talks to Anthropic, Gemini and OpenAI-compatible Chat Completions endpoints directly.
Run the following on macOS or Linux to install Ore:
curl -fsSL https://github.com/ore-cli/ore/releases/latest/download/install.sh | shRun the following on Windows to install Ore:
powershell -ExecutionPolicy ByPass -c "irm https://github.com/ore-cli/ore/releases/latest/download/install.ps1 | iex"Ore can also be installed via the following package managers:
# Install using npm
npm install -g @ore-cli/ore# Install using Homebrew
brew install ore-cli/tap/oremacOS, Linux and Windows, on ARM64 and x86_64.
The shell installer puts ore in ~/.local/bin, the PowerShell installer in %LOCALAPPDATA%\Programs\Ore\bin. Set CODEX_INSTALL_DIR to override either. Windows binaries are not signed yet, so SmartScreen warns on first run.
Then run ore. To check the install:
$ ore --version
ore 1.149.1
codex-base: rust-v0.149.1 (ff29a44391)openai, anthropic, gemini, ollama, lmstudio, amazon-bedrock and amazon-bedrock-runtime are built in. Set one in ~/.ore/config.toml and export its key:
model_provider = "anthropic"Anthropic reads ANTHROPIC_API_KEY, Gemini GEMINI_API_KEY. ANTHROPIC_BASE_URL and GEMINI_BASE_URL point either at a gateway, unless a table under that id replaces the built-in. ORE_MODEL_PROVIDER and ORE_MODEL select from the environment when no config layer has set them.
For anything else, add a provider table. wire_api picks the protocol — "responses", "chat", "anthropic" or "gemini". Most local servers and OpenAI-compatible proxies want "chat":
model_provider = "local"
[model_providers.local]
base_url = "http://localhost:8080/v1"
wire_api = "chat"The built-in ollama and lmstudio providers speak "responses", and a table under an existing id is ignored. To reach either over Chat Completions, define a provider under a different id.
Config lives in ~/.ore. ORE_HOME moves it. An existing ~/.codex/config.toml is merged in underneath, with ~/.ore winning where the two disagree; setting CODEX_HOME instead pins that directory as the only home and reads no layer beneath it. A project-local .codex/ directory is still read under that name.
Run ore and select Sign in with ChatGPT to use your Plus, Pro, Business or Enterprise plan, or sign in with an API key. The browser page that completes sign-in says Codex.
| Area | Codex | Ore |
|---|---|---|
| Telemetry | metrics, analytics, feedback reports | none |
| Config home | ~/.codex |
~/.ore |
| Wire APIs | Responses | Responses, Chat Completions, Anthropic, Gemini |
git clone https://github.com/ore-cli/ore.git
cd ore/codex-rs
cargo build --release --bin codexThe binary is target/release/codex; rename it to ore. --bin codex builds the agent alone — drop the flag to build codex-code-mode-host as well. Packaged installs also bundle ripgrep, and a source build falls back to rg on your PATH.
Providers is Ore's. The rest of docs/ is inherited from Codex and still describes it. Getting started · Configuration · Providers · Authentication · Sandbox · Installing & building · Contributing · Security · How the fork is built
Apache-2.0. Ore is a fork of OpenAI Codex, Copyright 2025 OpenAI. Files throughout are modified from the originals; see NOTICE. Ore is not affiliated with, endorsed by, or sponsored by OpenAI.