Codai.Core 2.1.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Codai.Core --version 2.1.0
                    


                    

                
NuGet\Install-Package Codai.Core -Version 2.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Codai.Core" Version="2.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Codai.Core" Version="2.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Codai.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Codai.Core --version 2.1.0
                    


                    

                
#r "nuget: Codai.Core, 2.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Codai.Core@2.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Codai.Core&version=2.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Codai.Core&version=2.1.0
                    


                            Install as a Cake Tool

<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.
Scoped instructions Combine standard instruction files, refresh each request, and review relevant nested guidance before file tools, including read-only subagents. Project instructions.
On-demand context Open sessions without a full-project indexing pass; discover files through tools as needed.
Workspace trust Review directory access before every CLI launch with Yes selected first; No or Escape declines. Scripted runs require --trust-directory; tool approvals stay separate. Permissions.
Controlled execution Validate tool arguments and bound repeated calls. Interactive terminals start with auto approval; use Shift+Tab or --auto-approve false to review writes and commands. Headless runs require explicit approval.
Focused terminal UI Read numbered, syntax-colored code panes; scroll the transcript and expand action steps, command output, and file diffs.
Terminal commands Stay in one conversation screen; use /session to switch saved chats and /settings for configuration and runtime views. Browse numbered model, agent, and theme menus, matching multi-select Skills and MCP managers, full-screen diffs, and the settings action palette. Menus share a concise Enter/Escape footer. Command reference.
Your choice of models Connect hosted providers or local servers, including Ollama.
Configuration and state Keep runtime settings and discovery metadata in configuration; Codai manages per-project MCP/skill selections in private state. Configuration.
Reusable workflows Match checked skill descriptions to your task in foreground and read-only subagents, loading relevant instructions on demand. Include shared repository, personal, and nested skills with invocation/path metadata. Manage availability in /skills; manual workflows remain in / completion. Skills.
Long-running work Budget context for the selected model, compact growing tool output between model calls, summarize with /compact, and adjust windows with /autocompact. Resume with codai code --continue. Context.
Extensible tools Read layered and VS Code-style MCP definitions; open interactive workspaces without waiting for MCP connections, then connect enabled servers on the first model request and discover relevant schemas on demand. Add .NET plugins and hooks under the same approval policy. MCP.

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-large-4
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 VS Code extension and editor workflows

Contributing

Bug reports, feature requests and pull requests are welcome. Start with CONTRIBUTION.md; report security issues through

License

Apache 2.0 © 2026 Codai contributors

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Codai.Core:

Package Downloads
Codai.Adapters

Codai integrations for configuration, providers, tools, analysis, pricing, storage, and MCP.
Codai.Application

Host-neutral application runtime shared by the Codai CLI, VS Code integration, and Rider integration.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.2.0 0 11/13/2026
2.1.0 105 11/10/2026
2.0.3 145 10/30/2026
2.0.2 114 10/30/2026
2.0.1 137 10/23/2026
2.0.0 123 10/23/2026