Codi - Your AI Coding Wingman

Multi-provider AI assistant for the terminal. Read, write, search, and refactor code with Claude, OpenAI, Ollama, and more.

Version 0.18.2 License AGPL-3.0 Node >=22 Default Claude Opus 4.5
Get Started View on GitHub

See it in action

Terminal - codi
Codi demo showing AI-assisted coding in the terminal

Why Codi?

Powerful features designed for real developer workflows

Multi-Provider Support Safety First Built-in Commands

Features

Everything you need to supercharge your coding workflow with AI

🔌

Multi-Provider Support

Switch between Claude (Opus 4.5, Sonnet 4), OpenAI (GPT-5, o3), Ollama (local), Ollama Cloud, or RunPod serverless with a single flag.

🛠

Powerful Tools

AI can read/write files, search code with regex, execute commands, apply patches, analyze images, and search the web.

⚡

Smart Context

Auto-detects project type and framework. Intelligent context compaction keeps conversations flowing without losing important details.

🎯

Code Commands

Built-in slash commands for explaining, refactoring, testing, reviewing, and documenting code. Full Git integration included.

🔒

Safety First

Dangerous operations require approval. Diff previews before changes. Full undo/redo history for all file modifications.

🧩

Session Memory

Save and restore sessions. Persistent memories across sessions. User profiles for personalized responses.

🤖

Multi-Agent Orchestration

Run parallel AI agents in isolated git worktrees. Permission requests bubble up to you for human-in-the-loop approval.

Built-in Tools

The AI has access to powerful tools for navigating and modifying your codebase

📄

read_file

Read any file

✏

write_file

Create or overwrite files

📝

edit_file

Search & replace edits

🔍

grep

Regex search in files

📂

glob

Find files by pattern

💻

bash

Run shell commands

🌐

web_search

Search the web

📷

analyze_image

Vision analysis

🎲

run_tests

Auto-detect & run tests

🗂

patch_file

Apply unified diffs

📃

insert_line

Insert at line number

📁

list_directory

List directory contents

Quick Start

Get up and running in under a minute

Install Codi

git clone https://github.com/laynepenney/codi.git
cd codi
corepack enable
pnpm install && pnpm build
pnpm link --global

Configure your API key

# For Claude (default - uses Opus 4.5)
export ANTHROPIC_API_KEY="your-key-here"

# For OpenAI
export OPENAI_API_KEY="your-key-here"

# For Ollama (free, runs locally)
ollama pull llama3.2

# For Ollama Cloud (after signin)
ollama signin

Start coding with AI

# With Claude (default: Opus 4.5)
codi

# With OpenAI
codi --provider openai --model gpt-5

# With Ollama (local, free)
codi --provider ollama --model llama3.2

# With Ollama Cloud
codi --provider ollama-cloud --model llama3.2

Supported Providers

Use any AI provider that fits your needs

🎨

Anthropic

Claude Opus 4.5, Opus 4, Sonnet 4, 3.5 Haiku

Default
🎬

OpenAI

GPT-5, GPT-5 Nano, GPT-4o, o1, o3-mini

💫

Ollama

Llama 3, DeepSeek, Qwen, CodeLlama (local)

☁

Ollama Cloud

Hosted Ollama with rate limiting

🚀

RunPod

Serverless GPU endpoints

Commands

Powerful slash commands for common workflows

📚 Information Prompts

/prompt explain <file>

Explain code in a file

/prompt review <file>

Code review

/prompt analyze <file>

Analyze structure

/prompt summarize <file>

Summarize code

🔨 Code Actions

/code refactor <file>

Refactor for quality

/code fix <file> <issue>

Fix a bug or issue

/code test <file>

Generate tests

/code doc <file>

Generate documentation

/code optimize <file>

Optimize performance

📌 Git Integration

/git commit

Generate commit message

/git pr

Generate PR description

/git diff

Explain git diff

/git branch

Manage branches

/git stash

Manage stash

/git log

Show history

/git status

Detailed status

/git undo

Undo git changes

/git merge

Merge with guidance

/git rebase

Rebase with warnings

💾 Sessions & Memory

/save [name]

Save conversation

/load <name>

Load session

/sessions

List all sessions

/remember <fact>

Remember for later

/memories

List memories

/profile

User preferences

📊 Usage & Models

/usage

Show token usage & costs

/models

List available models

/switch <model>

Switch model mid-session

🔄 Context & History

/compact

Manage context size

/revert-file

Undo last file change

/filehistory

View file changes

/redo

Redo undone change

🤖 Multi-Agent Orchestration

/delegate <branch> <task>

Spawn worker in worktree

/workers

List active workers

/workers cancel <id>

Cancel a worker

/worktrees

List managed worktrees

Ready to code smarter?

Join developers who are shipping faster with AI-powered coding assistance.

Get Started Now Star on GitHub