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
-
Clone the repository:
git clone https://github.com/yourusername/ollama-cli.git cd ollama-cli -
Install in editable mode:
pip install -e .
Usage
Run the CLI:
ollama-cli
Full Documentation
For detailed information on architecture, tool list, and advanced configurations, see DOCUMENTATION.md.
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