Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other models.
docs: add codex app (#16163)
Parth Sareenb9c0421f03e4
diff --git a/docs/docs.json b/docs/docs.jsonindex 79db465d6..fa73b7712 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -123,6 +123,7 @@"expanded": true,"pages": ["/integrations/claude-code",+ "/integrations/codex-app","/integrations/codex","/integrations/copilot-cli","/integrations/opencode",diff --git a/docs/images/codex-app-annotate.png b/docs/images/codex-app-annotate.pngnew file mode 100644index 000000000..0311f10f7Binary files /dev/null and b/docs/images/codex-app-annotate.png differdiff --git a/docs/images/codex-app-home.png b/docs/images/codex-app-home.pngnew file mode 100644index 000000000..ee6e9a8e1Binary files /dev/null and b/docs/images/codex-app-home.png differdiff --git a/docs/images/codex-app-review.png b/docs/images/codex-app-review.pngnew file mode 100644index 000000000..fb0d03e24Binary files /dev/null and b/docs/images/codex-app-review.png differdiff --git a/docs/integrations/codex-app.mdx b/docs/integrations/codex-app.mdxindex f93bdbadc..13c85e2e7 100644--- a/docs/integrations/codex-app.mdx+++ b/docs/integrations/codex-app.mdx@@ -2,38 +2,81 @@title: Codex App---+Codex App is OpenAI's desktop coding agent for macOS and Windows. Ollama configures the app to use Ollama's OpenAI-compatible endpoint, so Codex can work with local models and Ollama Cloud models in the desktop app.++<img+ src="/images/codex-app-home.png"+ alt="Codex App with Ollama selected"+ style={{ borderRadius: "12px" }}+/>+## Install-Install the [Codex App](https://developers.openai.com/codex/app/overview/) for macOS or Windows.+Install the [Codex App](https://developers.openai.com/codex/quickstart/) for macOS or Windows.-## Usage with Ollama+<Note>Codex App support is available in Ollama v0.24.0 and newer.</Note>-<Note>Codex works best with a larger context window. It is recommended to use a context window of at least 64k tokens.</Note>-### Quick setup+## Quick setup```shellollama launch codex-app```-To choose a model:+Once Codex App opens, start a task or open a repository as usual.++## Built-in browser++Codex App can open local servers and sites in its built-in browser. Annotate directly on the page to request changes.++<img+ src="/images/codex-app-annotate.png"+ alt="Codex App browser annotations"+ style={{ borderRadius: "12px" }}+/>++## Review mode++Use review mode to inspect code changes, leave comments, and iterate on fixes without leaving the app.++<img+ src="/images/codex-app-review.png"+ alt="Codex App review comments"+ style={{ borderRadius: "12px" }}+/>++### Run directly with a model```shell-ollama launch codex-app --model gpt-oss:120b+ollama launch codex-app --model kimi-k2.6:cloud```-To configure without launching:+Use a local model by passing its model name:```shell-ollama launch codex-app --config+ollama launch codex-app --model gemma4:31b```-To restore your usual Codex profile:+Running `ollama launch codex-app` is persistent and will have your model selected next time you open Codex.+++### Restore Codex App++To switch Codex App back to the profile you were using before `ollama launch codex-app`, run:```shellollama launch codex-app --restore```-## Backups+Ollama restores Codex App's settings and configs. If Codex App is open, Ollama asks before restarting it.+++The Codex CLI profile managed by `ollama launch codex` is left separate from the Codex App profile.Before overwriting Codex App config files, Ollama Launch saves backups under `~/.ollama/backup/codex-app/`. On Windows, `~` resolves to your user profile directory.++## Troubleshooting++If Codex App does not open after setup, open Codex manually once and run `ollama launch codex-app` again.++If Codex App is already running and does not switch models, allow Ollama to restart it when prompted, or quit Codex App and run `ollama launch codex-app` again.diff --git a/docs/integrations/index.mdx b/docs/integrations/index.mdxindex 00a550643..89cd95fa6 100644--- a/docs/integrations/index.mdx+++ b/docs/integrations/index.mdx@@ -9,8 +9,8 @@ Ollama integrates with a wide range of tools.Coding assistants that can read, modify, and execute code in your projects.- [Claude Code](/integrations/claude-code)-- [Codex CLI](/integrations/codex)- [Codex App](/integrations/codex-app)+- [Codex CLI](/integrations/codex)- [Copilot CLI](/integrations/copilot-cli)- [OpenCode](/integrations/opencode)- [Droid](/integrations/droid)