Tangent.Cli
0.1.0-preview.1
This is a prerelease version of Tangent.Cli.
dotnet tool install --global Tangent.Cli --version 0.1.0-preview.1
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
dotnet tool install --local Tangent.Cli --version 0.1.0-preview.1
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Tangent.Cli&version=0.1.0-preview.1&prerelease
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package Tangent.Cli --version 0.1.0-preview.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Tangent.Cli
The tangent command for Tangent, an architectural conformance checker for .NET.
The CLI contains the same analyzer as Tangent.Analyzers, so tangent check works on a solution that references no Tangent package at all.
Install
As a local tool, so the team and CI use the same version:
dotnet new tool-manifest
dotnet tool install Tangent.Cli --prerelease
dotnet tangent --help
Or globally:
dotnet tool install --global Tangent.Cli --prerelease
Tangent is in preview, so the install needs --prerelease.
Commands
| Command | What it does |
|---|---|
tangent init |
Writes .tangent/project.tan with one layer per root namespace of the solution, and a starter contracts.tan. |
tangent lint |
Parses and binds the .tan files, and resolves their type names against the solution. |
tangent check |
Runs every contract over the solution. Writes SARIF with --sarif and JSON with --json. --explain adds the rule text and the offending line to each violation. |
tangent diff |
Prints the code fixes as a unified diff. --apply writes them. |
tangent graph |
Exports tangent.graph.json. Open it in the viewer at caybokotze.github.io/tangent, which reads the file in your browser. |
tangent serve |
Runs the language server for .tan files over stdio. |
In CI
dotnet tool restore
dotnet tangent check --sarif tangent.sarif
| Exit code | Meaning |
|---|---|
| 0 | No violation at or above --fail-on. The default is error, so warnings alone exit 0. |
| 1 | Violations at or above --fail-on. Use --fail-on warning to fail on warnings too. |
| 2 | The .tan model has errors, so nothing was checked. |
| 3 | The solution, a project or the .tangent folder could not be loaded. |
The full reference is docs/cli.md.
| 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.
This package has no dependencies.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.1.0-preview.1 | 77 | 10/13/2026 |