AiCodeCompiler 0.7.0

There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global AiCodeCompiler --version 0.7.0
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local AiCodeCompiler --version 0.7.0
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=AiCodeCompiler&version=0.7.0
                    
nuke :add-package AiCodeCompiler --version 0.7.0
                    

AI Code Compiler

Compiles C# solutions into AI-agent-friendly documentation and exposes it via an MCP server so coding agents can query your codebase through structured tools.

Quick Start

# Install
dotnet tool install --global AiCodeCompiler --source https://api.nuget.org/v3/index.json

# Compile (auto-detects .sln in current directory)
cd path/to/your/project
compile-for-ai

That's it! A .codemap/ folder is generated and an MCP server is registered in .vscode/mcp.json.

Upgrade

dotnet tool update --global AiCodeCompiler --source https://api.nuget.org/v3/index.json

Commands

Command Description
compile-for-ai Compile the solution (default command)
compile-for-ai watch Watch mode — auto-recompile on file changes
compile-for-ai mcp Start the MCP server manually

Compile Options

Option Description
-s, --solution <path> Path to .sln (auto-detected if not specified)
-o, --output <path> Output directory (default: .codemap/)
-v, --verbose Show detailed progress and all warnings
-y, --yes Skip confirmation when multiple solutions found

What It Generates

Output Purpose
.codemap/*.md Structured markdown — solution overview, architecture, endpoints, types
.codemap/codemap.json Structured data for the MCP server
.codemap/dashboard.html Interactive HTML dashboard with search, themes, and diagnostics
.vscode/mcp.json MCP server auto-registered for agent access

MCP Server — Agent-Powered Queries

After compilation, an MCP server is registered so AI agents can query your codebase through 8 tools:

Tool Description
get_solution_overview High-level summary
search_types Find types by name/pattern
get_project_details Full project info
get_endpoints All API endpoints
get_type_details Type methods, properties, inheritance
get_diagnostics Warnings and errors
get_architecture DI, patterns, dependency graph
get_file_context Types/endpoints in a specific file

How Agents Benefit

Without codemap: agent reads files one by one, spends iterations understanding structure. With codemap: agent queries search_types("Order") → instantly knows the model, its methods, where it's used, and which endpoints depend on it. Fewer iterations, better accuracy.

What Gets Extracted

  • Types (classes, interfaces, records, enums) with methods and properties
  • API endpoints with routes, auth, request/response types
  • DI registrations with lifetimes
  • Project dependencies and references
  • Configuration (appsettings), Dockerfiles, CI/CD pipelines
  • Compilation diagnostics (warnings and errors)
  • Call graph and type relationships

Requirements

  • .NET 9 SDK
  • A C# solution (.sln) file
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  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.

This package has no dependencies.

Version Downloads Last Updated
0.9.2 111 4/2/2026
0.9.1 107 4/2/2026
0.9.0 111 4/2/2026
0.8.1 110 4/2/2026
0.8.0 99 4/1/2026
0.7.0 95 4/1/2026
0.6.1 95 4/1/2026
0.6.0 109 4/1/2026
0.5.0 100 4/1/2026
0.4.0 101 4/1/2026
0.3.1 102 4/1/2026
0.3.0 114 4/1/2026
0.2.1 93 4/1/2026
0.2.0 99 4/1/2026
0.1.1 103 4/1/2026
0.1.0 108 4/1/2026