Codai 2.0.3
dotnet tool install --global Codai --version 2.0.3
dotnet new tool-manifest
dotnet tool install --local Codai --version 2.0.3
#tool dotnet:?package=Codai&version=2.0.3
nuke :add-package Codai --version 2.0.3
<p align="center"> <img src="assets/codai-logo.png" alt="Codai" width="480" /> </p>
<p align="center"> The open source coding agent for your terminal. </p>
<br>
<p align="center"> <img src="assets/codai.png" alt="Codai working in a terminal" /> </p>
Installation
dotnet tool install --global codai
Documentation
For full instructions on how to use Codai, see the docs.
What it does
| Capability | How it helps |
|---|---|
| Plan, then act | Read and search without changing files or running commands; switch to Agent for implementation. |
| Project-wide edits | Read, search, and edit real files with your project's guidance in context. |
| On-demand context | Open sessions without a full-project indexing pass; discover files through tools as needed. |
| Controlled execution | Review writes and commands under your approval policy. Shell commands require shell access. |
| Focused terminal UI | Scroll the transcript with input pinned; expand action steps, command output, and file diffs. |
| Your choice of models | Connect hosted providers or local servers, including Ollama. |
| Reusable workflows | Apply project guidance, rules, skills, commands, and memory documents. |
| Long-running work | Compact context and resume a previous session with codai code --continue. |
| Extensible tools | Add MCP servers, .NET plugins, and lifecycle hooks under the same approval policy. |
Supported providers
Connect through codai auth, or select a provider with --provider and a model with
--model.
| Provider | --provider |
Hosting | Default model |
|---|---|---|---|
| OpenAI | openai |
Cloud | gpt-5.4-mini |
| Azure OpenAI | azure-openai |
Cloud | Your deployment ID |
| Anthropic | anthropic |
Cloud | claude-sonnet-4-6 |
| Google Gemini | gemini |
Cloud | gemini-3.8-flash |
| Ollama | ollama |
Local | qwen3-coder |
| DeepSeek | deepseek |
Cloud | deepseek-flash |
| OpenRouter | openrouter |
Cloud | openai/gpt-5.4-mini |
| Qwen (DashScope) | qwen |
Cloud | qwen3.7-plus |
| Mistral | mistral |
Cloud | mistral-medium-3-5 |
| Grok (xAI) | grok |
Cloud | grok-4.7 |
Hosted providers require API credentials. Local Ollama does not require an API key.
OpenAI also supports Continue with ChatGPT for eligible accounts through codai auth;
account-plan access and API credentials are separate connections.
Model availability and coding-tool support depend on the selected provider and model.
Setup fetches live model catalogs, with bundled suggestions when discovery is unavailable.
See model selection and compatibility.
Bundled model choices include provider-specific USD estimates and prompt-length tiers;
see pricing coverage and limitations.
Documentation
Documentation uses Nextra, with Codai's default blue, light/dark themes, local
full-text search, and guided setup. GitHub Actions builds and publishes the static site
to GitHub Pages when documentation changes reach main; no hosted docs account is
required. See documentation development for local preview.
| Guide | Covers |
|---|---|
| Overview | Introduction to Codai |
| Quickstart | Installation, model connection, and your first session |
| Plan and Agent | Read-only investigation and deliberate implementation |
| Tools | Built-in capabilities, limits, and tool access |
| Terminal | Composer, shortcuts, action steps, and diffs |
| Permissions | Approval policy and unattended execution |
| Sessions and recovery | Saved conversations, tasks, and checkpoints |
| Providers and models | Connections, model selection, usage, and pricing |
| Configuration | Saved settings, scopes, and overrides |
| Project instructions | Repository conventions, rules, and memory |
| CLI reference | Entry points, flags, and exit codes |
| Troubleshooting | Setup, models, permissions, and terminal issues |
| Skills | Project and global skills |
| Plugins | Custom tools and lifecycle hooks |
| MCP integrations | External tool servers |
| ACP compatibility | Supported editor integration and current limits |
| Roadmap | Planned work and implementation status |
Contributing
Bug reports, feature requests and pull requests are welcome. Start with CONTRIBUTION.md; report security issues through
License
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.