Koder

Koder

[](https://www.python.org/downloads/) [](LICENSE) [](https://pepy.tech/projects/koder) [](https://github.com/psf/black) [](https://github.com/astral-sh/ruff)

An experimental, universal AI coding assistant for the terminal. Built in Python, Koder works with OpenAI, Anthropic, Google, GitHub Copilot, and 100+ providers via LiteLLM.

🎯 **Status**: Alpha - This is a learning-focused project exploring AI agent development.

Features

• Universal AI Support - Works with ChatGPT/Gemini/Claude subscriptions and API keys via OpenAI, Anthropic, Google, GitHub Copilot, and 100+ providers
• Smart Context - Persistent sessions with SQLite storage and automatic token-aware compression
• Real-time Streaming - Rich terminal displays with live output
• Comprehensive Tools - File operations, search, shell, task delegation, todos, and skills
• MCP Integration - Extensible tool ecosystem via Model Context Protocol
• Zero Config - Automatic provider detection with sensible defaults

Installation

Using uv (Recommended)

uv tool install koder

Using pip

pip install koder

Quick Start

# 1. Set your API key (works with any provider)
export KODER_API_KEY="your-api-key"

# 2. Run Koder
koder

That's it! `KODER_API_KEY` works with any provider - no need to remember provider-specific variable names.

Basic Usage

# Interactive mode
koder

# Single prompt
koder "create a Python function to calculate fibonacci numbers"

# Named session (persists conversation)
koder -s my-project "help me implement a new feature"

# Use a diffe