Note

TUI is under active development. APIs may change.

Code Ollama

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

Prerequisites

Set up Ollama.

Quick Start

npx code-ollama

Install

Install the CLI globally:

npm install --global code-ollama

Usage

TUI

Open the TUI:

code-ollama

Or use the alias:

collama

Skills

Skills are Markdown instructions loaded into the system prompt as context. They do not add tools or execute code.

Add project skills:

.code-ollama/skills/<skill-name>/SKILL.md

Add user skills:

~/.code-ollama/skills/<skill-name>/SKILL.md

Project skills load before user skills. Missing directories are ignored, and skills with the same directory name from both locations are both loaded with their source labels. Use /skills in the TUI to show loaded skills.

See example skill .code-ollama/skills/git-commit-staged/SKILL.md.

MCP

Tools can be loaded from stdio Model Context Protocol servers configured in ~/.code-ollama/config.json.

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Servers are enabled by default. Skip a server with disabled: true:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "disabled": true
    }
  }
}

MCP tools are exposed to the model with names like mcp__context7__resolve_library_id and use the existing tool approval flow. Use /mcp in the TUI to inspect configured servers, loaded tools, disabled servers, and startup errors. MCP tools are not available in plan mode.

CLI

Show the version:

code-ollama --version

Show the help:

code-ollama --help

Run a one-off prompt:

# code-ollama run --trust <model> <prompt>
code-ollama run --trust gemma4 "review diff"

License

MIT