Mistral Codex CLI

Codex CLI is a local-first coding agent powered by Mistral AI.

If you want Codex inside your editor (VS Code, Cursor, etc.) stay tuned for the upcoming IDE extension.

---

Quickstart

Installing and running Codex CLI

Install globally with your preferred package manager. If you use npm:

npm install -g @mistralai/codex

Alternatively, if you use Homebrew:

brew install mistral-codex

Then simply run codex to get started:

codex

Authenticate with your Mistral API key

Create an account on console.mistral.ai, generate an API key and export it:

export MISTRAL_API_KEY="sk-..."

Run codex and you’re ready to start coding with Mistral models.
See the authentication guide for details.

Model Context Protocol (MCP)

Codex CLI supports MCP servers. Enable by adding an mcp_servers section to your ~/.codex/config.toml.

Configuration

Codex CLI supports a rich set of configuration options, with preferences stored in ~/.codex/config.toml. For full configuration options, see Configuration.

---

Docs & FAQ

• Getting started
  • CLI usage
  • Running with a prompt as input
  • Example prompts
  • Memory with AGENTS.md
  • Configuration
• Sandbox & approvals
• Authentication
  • Auth methods
  • Login on a "Headless" machine
• Advanced
  • Non-interactive / CI mode
  • Tracing / verbose logging
  • Model Context Protocol (MCP)
• Zero data retention (ZDR)
• Contributing
• Install & build
  • System Requirements
  • DotSlash
  • Build from source
• FAQ
• Open source fund

---

License

This repository is licensed under the Apache-2.0 License.