CLI Reference

The calor command-line tool provides commands for working with Calor code and analyzing C# codebases for migration.

Installation

Install calor as a global .NET tool:

Bash
dotnet tool install -g calor

Or update an existing installation:

Bash
dotnet tool update -g calor

Available Commands

CommandDescription
calor (default)Compile Calor source files to C#
calor analyzeScore C# files for Calor migration potential
calor initInitialize Calor with AI agent support and .csproj integration
calor convertConvert single files between C# and Calor
calor migrateMigrate entire projects between C# and Calor
calor idsManage unique identifiers (check, assign, index)
calor benchmarkCompare Calor vs C# across evaluation metrics
calor formatFormat Calor source files to canonical style
calor lintCheck and auto-fix agent-optimized format issues
calor diagnoseOutput machine-readable diagnostics for tooling
calor mcpStart MCP server for AI agent integration
calor hookClaude Code hook commands (internal)

Compilation (Default Command)

Compile Calor source files to C#:

Bash
calor --input file.calr --output file.g.cs

Options

OptionDescription
--input, -iInput Calor file path (required)
--output, -oOutput C# file path (required)
--verbose, -vShow detailed compilation output

Example

Bash
# Compile a single file
calor --input src/MyModule.calr --output src/MyModule.g.cs

# Compile with verbose output
calor -v -i src/MyModule.calr -o src/MyModule.g.cs

See Also