ollama-cli/README.md

Ollama CLI v3.0

An extremely powerful, modular, and commercially-ready CLI for local Ollama LLMs. Inspired by Gemini CLI and Kiro CLI.

Features

• Rich UI: Beautifully formatted output using rich.
• Powerful REPL: Multi-line input, history, and completions via prompt_toolkit.
• Modular Tool System: Easily extensible tool architecture (Filesystem, System, Web, etc.).
• Session Management: Save and resume conversations with ease.
• Model Intelligence: Automatically switches models based on task type (coding vs. general).
• Streaming Responses: Real-time feedback as the model generates text.
• MCP Support: Ready for Model Context Protocol integration.
• Local First: Everything runs locally on your machine.

Installation

Prerequisites

• Python 3.8+
• Ollama installed and running.

From Source

1. Clone the repository:

   git clone https://github.com/yourusername/ollama-cli.git
   cd ollama-cli
   

2. Install in editable mode:

   pip install -e .
   

Usage

Run the CLI:

ollama-cli

Slash Commands

• /quit - Exit the CLI.
• /clear - Clear conversation history.
• /models - List available models.
• /model <name> - Switch to a specific model.
• /sessions - List recent sessions.
• /save [name] - Save the current session.
• /load <name> - Load a saved session.

Configuration

Config is stored at ~/.ollama-cli-config.json. You can configure:

• ollama_url: The URL of your Ollama server.
• default_model: The model to use by default.
• excluded_models: Models to hide from the list.

Architecture

• src/ollama_cli/core: Core logic (API, Config, Sessions).
• src/ollama_cli/tools: Tool implementations and registry.
• src/ollama_cli/ui: REPL and rich formatting.
• src/ollama_cli/integrations: External integrations (MCP, LSP, Notify).

License

MIT