Codai.Application
2.0.2
See the version list below for details.
dotnet add package Codai.Application --version 2.0.2
NuGet\Install-Package Codai.Application -Version 2.0.2
<PackageReference Include="Codai.Application" Version="2.0.2" />
<PackageVersion Include="Codai.Application" Version="2.0.2" />
<PackageReference Include="Codai.Application" />
paket add Codai.Application --version 2.0.2
#r "nuget: Codai.Application, 2.0.2"
#:package Codai.Application@2.0.2
#addin nuget:?package=Codai.Application&version=2.0.2
#tool nuget:?package=Codai.Application&version=2.0.2
<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>
<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 # First run: choose theme, provider, and model; later runs open chat
codai auth # Change the connection or selected model
New setups save user-wide defaults in ~/.codai/codai-config.json when no project
configuration exists. See first-run setup.
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 |
| 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. |
-
net10.0
- AngleSharp (>= 1.5.0)
- Azure.AI.OpenAI (>= 2.1.0)
- Codai.Adapters (>= 2.0.2)
- Codai.Core (>= 2.0.2)
- DiffPlex (>= 1.9.0)
- Microsoft.CodeAnalysis.CSharp (>= 5.9.0)
- Microsoft.Extensions.AI (>= 10.10.0)
- Microsoft.Extensions.AI.Abstractions (>= 10.10.1)
- Microsoft.Extensions.AI.OpenAI (>= 10.10.1)
- Microsoft.Extensions.Configuration (>= 10.0.12)
- Microsoft.Extensions.Configuration.Binder (>= 10.0.12)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.12)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.12)
- Microsoft.Extensions.Configuration.Json (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection (>= 10.0.12)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- Microsoft.Extensions.Hosting (>= 10.0.12)
- Microsoft.Extensions.Options (>= 10.0.12)
- Microsoft.IdentityModel.Protocols.OpenIdConnect (>= 8.23.0)
- ModelContextProtocol (>= 2.2.0)
- NetEscapades.Configuration.Yaml (>= 3.1.0)
- OpenAI (>= 2.14.0)
- System.Security.Cryptography.ProtectedData (>= 10.0.12)
- YamlDotNet (>= 13.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.