Note

TUI is under active development. APIs may change.

Code Ollama

🦙 Ollama coding agent that runs in your terminal. Read the documentation.

Prerequisites

Set up Ollama.

Quick Start

npx code-ollama

Install

Install the CLI globally:

npm install --global code-ollama

Download

Standalone executables for Linux, macOS, and Windows are also available from GitHub Releases. Extract the archive for your operating system and architecture, then run code-ollama (or code-ollama.exe on Windows).

Warning

OAuth authentication for MCP servers is not supported in standalone executables. Install the npm package when OAuth-backed MCP servers are required.

Usage

Open the interactive interface (TUI):

code-ollama

You can also use the collama alias:

collama

Check whether the configuration, Ollama connection, and selected model are ready:

code-ollama doctor

Run a one-off prompt:

code-ollama run gemma4 "Explain the package.json scripts"

For non-interactive use in a workspace you trust, pass --trust to save the current directory as trusted and skip the confirmation prompt:

code-ollama run --trust gemma4 "Explain the package.json scripts"

Documentation

• Getting started: Ollama, TUI, and CLI
• Features: MCP, Skills, Memory, Sessions, and Web Search
• Reference: Configuration

License

MIT