Minos.NET.Tool 1.13.1

Prefix Reserved
dotnet tool install --global Minos.NET.Tool --version 1.13.1
                    
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 Minos.NET.Tool --version 1.13.1
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Minos.NET.Tool&version=1.13.1
                    
nuke :add-package Minos.NET.Tool --version 1.13.1
                    

Minos.NET.Tool

The minos command line tool for Minos.NET: calibrate a decision model against a labelled dataset, build the calibration report again from saved results, and check that a provider conforms to the decision protocol.

dotnet tool install --global Minos.NET.Tool
minos --help

The tool needs the .NET 10 runtime.

Commands

Command What it does
minos calibrate Runs a labelled dataset against a provider, then writes the results and a calibration report.
minos report Builds the report again from saved results and their dataset, without calling a provider.
minos export Turns recorded decisions with confirmed outcomes into a labelled dataset and a signals file.
minos shadow-report Compares the primary and the candidate of shadowed decisions: agreement, confusion tables and calibration against confirmed outcomes.
minos conformance Sends the conformance probes to a live provider and checks its answers.

Run minos <command> --help for the options of each. Without --out, a command writes into minos-out/<provider>-<UTC time> in the current directory.

minos calibrate --dataset support.jsonl --provider typesafe --prices prices.json
minos report --dataset support.jsonl --results minos-out/typesafe-20261017-120000/results.jsonl
minos export --records decisions.jsonl
minos shadow-report --records decisions.jsonl --prices prices.json
minos conformance --provider typesafe

The config file

The tool reads minos.json in the current directory, or the file given with --config. Each provider is a section under Minos:Providers with the options of SystemOneDecisionClientOptions, and Minos:Active names the one used when --provider is not given. Environment variables override the file, so a key need not be written down: Minos__Providers__typesafe__ApiKey.

{
  "Minos": {
    "Active": "typesafe",
    "Providers": {
      "typesafe": { "Provider": "TypeSafe", "Model": "jev-1.14" },
      "local": { "Provider": "Custom", "BaseAddress": "http://localhost:8080/", "Path": "api/v1/systemone", "Model": "local-model" }
    }
  }
}

The prices file

A provider that reports no cost can be priced with --prices. Each entry names the model, the price per million tokens, and where and when the price was read.

{
  "prices": [
    { "model": "jev-1.14", "inputPerMillion": 0.042, "outputPerMillion": 0, "date": "2026-10-17", "source": "OpenRouter listing" }
  ]
}

Exit codes

Code Meaning
0 The command did what it was asked.
1 A run-time failure: a stopped run, a failed check, a network fault or an output directory that cannot be written.
2 The input, the usage or the configuration is wrong.
130 The command was cancelled: by Ctrl+C or Ctrl+Break, or on Unix by Ctrl+\ or SIGTERM. A cancelled minos calibrate still saves the items that finished as results.partial.jsonl, with its report; a second Ctrl+C quits without saving.

Documentation: Labelled datasets and the conformance suite. Source and issues: github.com/MarcelRoozekrans/Minos.NET. Licensed under the MIT license.

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.  net11.0 is compatible. 
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
1.13.1 54 11/12/2026
1.12.0 96 11/8/2026
1.11.2 95 11/7/2026
1.11.1 85 11/7/2026
1.11.0 98 11/6/2026
1.10.0 84 11/5/2026
1.9.0 97 11/4/2026
1.8.1 113 11/1/2026
1.8.0 113 10/31/2026
1.7.1 106 10/31/2026
1.7.0 108 10/30/2026
1.6.0 111 10/28/2026
1.5.0 105 10/28/2026
1.4.2 109 10/26/2026
1.4.1 105 10/25/2026
1.4.0 111 10/23/2026
1.3.0 106 10/23/2026
1.2.2 108 10/22/2026
1.2.1 112 10/18/2026
1.2.0 116 10/17/2026