benchmark
Compare Calor vs C# across evaluation metrics.
calor benchmark [project] [options]Overview
The benchmark command compares paired Calor and C# source across seven
categories:
- Token Economics - Token count and density
- Generation Accuracy - Code correctness
- Comprehension - Understandability
- Edit Precision - Targeted modification accuracy
- Error Detection - Bug identification
- Information Density - Meaning per token
- Task Completion - End-to-end success
This command is not the same surface as the published v0.12 website artifact,
which is generated by tests/Calor.Evaluation over 217 programs and currently
contains eight metrics. Do not expect one local calor benchmark invocation to
reproduce the 1.32x headline.
Quick Start
# Compare two files
calor benchmark --calor Calculator.calr --csharp Calculator.cs
# Benchmark entire project
calor benchmark ./src
# Quick token-only comparison
calor benchmark --calor file.calr --csharp file.cs --quick
# Generate markdown report
calor benchmark ./src --format markdown --output report.mdOptions
| Option | Short | Default | Description |
|---|---|---|---|
--calor | None | Calor file to benchmark | |
--csharp, --cs | None | C# file to benchmark | |
--category | -c | All | Filter by category |
--format | -f | console | Output format: console, markdown, json |
--output | -o | stdout | Save results to file |
--verbose | -v | false | Show detailed per-metric breakdown |
--quick | -q | false | Quick token-only benchmark |
File-Level Benchmark
Compare a specific Calor file against its C# equivalent:
calor benchmark --calor PaymentService.calr --csharp PaymentService.csUse --category with one of the seven exact category names above to narrow the
report. --format json emits the shared schema 2.0 envelope with benchmark
data under data; human status text moves to stderr.
Quick Benchmark
For a fast token, character, and line comparison without the full seven-metric evaluation:
calor benchmark --calor file.calr --csharp file.cs --quickQuick mode is descriptive only; inspect the separate token, character, and line values instead of treating its aggregate as proof of an agent advantage.
Exit Codes
| Code | Meaning |
|---|---|
0 | Benchmark completed successfully |
1 | Invalid category, missing input, missing file, or another command error |
Finding no paired files in project mode emits a warning and currently exits 0, so automation should inspect diagnostics as well as the process exit code.
See Also
- calor assess - Score files for migration potential
- Benchmarking Methodology - Detailed methodology
- Benchmark Results - Published results