library/docs-ollama
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Sync ollama docs from 12e04379 on 2026-06-12

Browse Source
This commit is contained in:
The Librarian
2026-06-12 04:00:06 +00:00
parent 7c43dfec77
commit 70feb5e845
33 changed files with 525 additions and 245 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/integrations/cline-cli.mdx
+98
View File
@@ -0,0 +1,98 @@
---
title: Cline CLI
---
Cline CLI is an autonomous coding agent for interactive terminal sessions.
<img
src="/images/cline-cli.png"
alt="Cline CLI launched with Ollama selected as the provider"
style={{ borderRadius: "12px" }}
/>
## Install
Install the [Cline CLI](https://docs.cline.bot/usage/cli-overview). For the IDE extension, see [Cline](/integrations/cline).
```bash
npm install -g cline
```
<Note>If Cline CLI is not installed and `npm` is available, `ollama launch cline` will prompt to install `cline@latest`.</Note>
## Usage with Ollama
### Quick setup
```bash
ollama launch cline
```
When launched through `ollama launch cline`, Ollama sets Cline's provider to Ollama, points it at the local Ollama endpoint, and selects the model you choose.
To configure without launching:
```shell
ollama launch cline --config
```
### Run directly with a model
```shell
ollama launch cline --model qwen3.5
```
To use a cloud model:
```shell
ollama launch cline --model kimi-k2.6:cloud
```
### Pass a prompt to Cline
Arguments after `--` are passed directly to Cline:
```shell
ollama launch cline -- "summarize this repository"
```
To open Cline's Kanban board:
```shell
ollama launch cline -- kanban
```
<img
src="/images/cline-kanban.png"
alt="Cline Kanban board opened from the CLI"
style={{ borderRadius: "12px" }}
/>
### Manual setup
To configure Cline CLI manually, first make sure Ollama is running and the model you want to use is available:
```shell
ollama pull qwen3.5
```
Then run Cline's interactive auth flow:
```shell
cline auth
```
Select Ollama as the provider, use `http://localhost:11434` as the base URL if prompted, and choose a model such as `qwen3.5` or `kimi-k2.6:cloud`.
To check the current Cline configuration:
```shell
cline config
```
To start an interactive session:
```shell
cline
```
docs/integrations/codex-app.mdx
+82
View File
@@ -0,0 +1,82 @@
---
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/quickstart/) for macOS or Windows.
<Note>Codex App support is available in Ollama v0.24.0 and newer.</Note>
## Quick setup
```shell
ollama launch codex-app
```
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 kimi-k2.6:cloud
```
Use a local model by passing its model name:
```shell
ollama launch codex-app --model gemma4:31b
```
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:
```shell
ollama launch codex-app --restore
```
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.
docs/integrations/codex.mdx
+17 -12
View File
@@ -1,11 +1,11 @@
---
title: Codex
title: Codex CLI
---
## Install
Install the [Codex CLI](https://developers.openai.com/codex/cli/):
Install the [Codex CLI](https://developers.openai.com/codex/cli/). For the desktop app, see [Codex App](/integrations/codex-app).
```
npm install -g @openai/codex
@@ -21,12 +21,21 @@ npm install -g @openai/codex
ollama launch codex
```
When launched through `ollama launch codex`, Ollama refreshes the model catalog
and uses a dedicated Codex profile for that session.
To configure without launching:
```shell
ollama launch codex --config
```
To remove the Ollama launch profile and generated model catalog:
```shell
ollama launch codex --restore
```
### Manual setup
To use `codex` with Ollama, use the `--oss` flag:
@@ -49,25 +58,21 @@ codex --oss -m gpt-oss:120b-cloud
### Profile-based setup
For a persistent configuration, add an Ollama provider and profiles to `~/.codex/config.toml`:
For a persistent Codex CLI configuration, create `~/.codex/ollama-launch.config.toml`:
```toml
[model_providers.ollama-launch]
name = "Ollama"
base_url = "http://localhost:11434/v1"
[profiles.ollama-launch]
model = "gpt-oss:120b"
model_provider = "ollama-launch"
model_catalog_json = "/Users/you/.codex/model.json"
[profiles.ollama-cloud]
model = "gpt-oss:120b-cloud"
model_provider = "ollama-launch"
[model_providers.ollama-launch]
name = "Ollama"
base_url = "http://localhost:11434/v1/"
wire_api = "responses"
```
Then run:
```
codex --profile ollama-launch
codex --profile ollama-cloud
```
docs/integrations/hermes-desktop.mdx
+28
View File
@@ -0,0 +1,28 @@
---
title: Hermes Desktop
---
Hermes Desktop is a native AI assistant app by Nous Research. It provides a desktop chat interface for Hermes Agent, an AI agent that can work with models, run tools, manage projects, use memory and skills, and connect to messaging gateways.
![Hermes Desktop with Ollama](http://files.ollama.com/hermes-agent.png)
## Quick start
```bash
ollama launch hermes-desktop
```
Ollama handles the setup flow automatically:
1. **Install** - If Hermes Desktop isn't installed, Ollama prompts to install it
2. **Model** - Pick a model from the selector
3. **Configure** - Ollama configures Hermes Desktop to use your selected Ollama model
4. **Launch** - Ollama opens Hermes Desktop
## Run directly with a model
```bash
ollama launch hermes-desktop --model <model>
```
Run `ollama launch hermes-desktop` again to switch models later.
docs/integrations/hermes.mdx
-2
View File
@@ -19,8 +19,6 @@ Ollama handles everything automatically:
3. **Onboarding** — Ollama configures the Ollama provider, points Hermes at `http://127.0.0.1:11434/v1`, and sets your model as the primary
4. **Gateway** — Optionally connects a messaging platform (Telegram, Discord, Slack, WhatsApp, Signal, Email) and launches the Hermes chat
<Note>Hermes on Windows requires WSL2. Install it with `wsl --install` and re-run from inside the WSL shell.</Note>
## Recommended models
**Cloud models**:
docs/integrations/index.mdx
+5 -1
View File
@@ -9,11 +9,14 @@ 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](/integrations/codex)
- [Codex App](/integrations/codex-app)
- [Codex CLI](/integrations/codex)
- [Copilot CLI](/integrations/copilot-cli)
- [Cline CLI](/integrations/cline-cli)
- [OpenCode](/integrations/opencode)
- [Droid](/integrations/droid)
- [Goose](/integrations/goose)
- [Oh My Pi](/integrations/oh-my-pi)
- [Pi](/integrations/pi)
- [Pool](/integrations/pool)
@@ -23,6 +26,7 @@ AI assistants that help with everyday tasks.
- [OpenClaw](/integrations/openclaw)
- [Hermes Agent](/integrations/hermes)
- [Hermes Desktop](/integrations/hermes-desktop)
## IDEs & Editors
docs/integrations/oh-my-pi.mdx
+35
View File
@@ -0,0 +1,35 @@
---
title: Oh My Pi
---
Oh My Pi (OMP) is a terminal coding agent with IDE-style tools built in. It combines chat, project context, structured code edits, language server support, debugging tools, browser access, plugins, and subagents in one terminal workflow.
Ollama can configure OMP to use Ollama as its model provider and launch an interactive session.
![Oh My Pi with Ollama](http://files.ollama.com/omp.png)
## Quick setup
```bash
ollama launch omp
```
This configures Ollama as a provider, sets up web search tools, and starts OMP.
### Run directly with a model
```shell
ollama launch omp --model <model>
```
## Plugins
OMP supports plugins for extra tools and capabilities. When launching OMP through Ollama, the Ollama web search plugin is managed automatically.
## Manual setup
Install OMP from [omp.sh](https://omp.sh), then run:
```bash
ollama launch omp --config
```
docs/integrations/pi.mdx
+12 -12
View File
@@ -4,23 +4,13 @@ title: Pi
Pi is a minimal and extensible coding agent.
## Install
Install [Pi](https://github.com/badlogic/pi-mono):
```bash
npm install -g @mariozechner/pi-coding-agent
```
## Usage with Ollama
### Quick setup
## Quick setup
```bash
ollama launch pi
```
This installs Pi, configures Ollama as a provider including web tools, and drops you into an interactive session.
This installs Pi if needed, configures Ollama as a provider including web tools, and drops you into an interactive session.
To configure without launching:
@@ -80,6 +70,16 @@ Each kept experiment is automatically committed. Each failed one is reverted. Wh
## Manual setup
### Install
Install [Pi](https://github.com/earendil-works/pi):
```bash
npm install -g @earendil-works/pi-coding-agent
```
Add a configuration block to `~/.pi/agent/models.json`:
```json