Codai 2.0.1
See the version list below for details.
dotnet tool install --global Codai --version 2.0.1
dotnet new tool-manifest
dotnet tool install --local Codai --version 2.0.1
#tool dotnet:?package=Codai&version=2.0.1
nuke :add-package Codai --version 2.0.1
<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>
<p align="center"> Your terminal. Your models. Your project, with you in control. </p>
<div align="center"> <table> <tbody> <td align="center"> <a href="https://meysamhadeli.github.io/codai" target="_blank"><strong>Docs</strong></a> </td> <td align="center"> <a href="https://github.com/meysamhadeli/codai/discussions" target="_blank"><strong>Discussions</strong></a> </td> <td align="center"> <a href="https://github.com/meysamhadeli/codai/issues" target="_blank"><strong>Issues</strong></a> </td> <td align="center"> <a href="CONTRIBUTION.md" target="_blank"><strong>Contributing</strong></a> </td> </tbody> </table> </div>
<br>
<p align="center"> <img src="assets/codai.png" alt="Codai working in a terminal" /> </p>
Explore a codebase, plan a change, and work across files with explicit approval for writes and commands. Start read-only in Plan mode, then switch to Agent when you are ready to build.
Installation
Requires the .NET SDK 10.0 or later.
dotnet tool install --global Codai
Usage
Run from your project directory:
codai auth # Connect a provider and select a model
codai code # Start a coding session
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 |
|---|---|---|
| OpenAI | openai |
Cloud |
| Azure OpenAI | azure-openai |
Cloud |
| Anthropic | anthropic |
Cloud |
| Google Gemini | gemini |
Cloud |
| Ollama | ollama |
Local |
| DeepSeek | deepseek |
Cloud |
| OpenRouter | openrouter |
Cloud |
| Qwen (DashScope) | qwen |
Cloud |
| Mistral | mistral |
Cloud |
| Grok (xAI) | grok |
Cloud |
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.
Documentation
Documentation now uses Mintlify, with Codai's default blue, light/dark themes, search, native cards, and guided setup.
Hosting transition: Links below still point to the legacy GitHub Pages site. The new Mintlify overview and Quickstart are available in local preview; publication is pending a Mintlify connection. See documentation development for preview and publishing instructions.
| Guide | Covers |
|---|---|
| Overview | Introduction to Codai |
| Agent mode | Modes, approval policy, terminal controls, and session recovery |
| 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.