Codai.Core
2.2.0
dotnet add package Codai.Core --version 2.2.0
NuGet\Install-Package Codai.Core -Version 2.2.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.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Codai.Core" Version="2.2.0" />
<PackageReference Include="Codai.Core" />
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.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Codai.Core, 2.2.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.2.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.2.0
#tool nuget:?package=Codai.Core&version=2.2.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
<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
Requires the .NET 10 SDK.
dotnet tool install --global codai
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 syntax-colored code panes and recognizable Nerd Font action icons; expand tool output and diffs. Use CODAI_ICONS=unicode without a Nerd Font. Terminal. |
| Session tabs | Open, switch, and close conversations from the terminal's top strip, keeping separate histories, modes, transcripts, scroll positions, and drafts. Session tabs. |
| In-app updates | Check the latest stable release with /update or the Update menu action; approve installation or see that your version is already up to date. Updating. |
| 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. |
| Read-only delegation | Give focused investigations separate context; manage background agents and bounded specialist teams without granting write access. Context and delegation. |
| Sessions and recovery | Resume or branch saved conversations, inspect task history, and restore workspace checkpoints with explicit consent. Recovery. |
| 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. |
| Lifecycle policy | Run bounded, approved task/tool hooks and inspect them without execution. Disable hooks independently from model guidance. Hooks. |
| Automation and hosting | Run one-shot tasks with JSON Lines, use the documented ACP subset, or supply your own .NET UI and approval policy. Hosting. |
| Extensible tools | Discover MCP tools on demand; install Claude and GitHub Copilot marketplace skills, commands, MCP definitions, and supported command hooks. Explicitly trust publishers and approve imported MCP servers. Native .NET plugins remain available. MCP · Plugins and compatibility. |
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 |
| Context and delegation | Compaction, context windows, background agents, and specialist teams |
| Project instructions | Repository conventions, rules, and memory |
| Custom commands | Named prompt workflows and arguments |
| Lifecycle hooks | Native manifests, events, consent, and fail-closed limits |
| CLI reference | Entry points, flags, and exit codes |
| Hosting and automation | JSON Lines, .NET runtime composition, and host responsibilities |
| Troubleshooting | Setup, models, permissions, and terminal issues |
| Skills | Project and global skills |
| Plugins | Claude/Copilot bundle installation, runtime contributions, compatibility, and .NET tools |
| MCP integrations | External tool servers |
| ACP compatibility | Supported editor integration and current limits |
Contributing
Bug reports, feature requests and pull requests are welcome. Start with CONTRIBUTION.md.
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. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- JsonSchema.Net (>= 9.6.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.12)
- YamlDotNet (>= 13.0.1)
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.