Installation

Shell
dotnet tool install -g curb-cli

Installs the curb command globally. Requires the .NET 10 SDK or later on the platforms below; the portable fallback for any other platform needs .NET 11. After this, curb format ./src and curb check ./src work from any directory.

The tool ships as a native-AOT binary per platform — about 11 MB, about 10 ms to start — with a portable managed fallback for platforms not in the list.

Supported platforms:

Platform RID
Linux x64 linux-x64
Linux arm64 linux-arm64
Windows x64 win-x64
Windows arm64 win-arm64
macOS arm64 osx-arm64

To update:

Shell
dotnet tool update -g curb-cli
Xml
<PackageReference Include="curb" Version="*" PrivateAssets="all" />

Add this to your Directory.Build.props (or directly to a project file) and dotnet build will format your source before compiling it. The package is build-only — nothing lands in your output assemblies.

The package bundles a framework-dependent build of the CLI. To use the native binary instead, which starts roughly 100× faster:

Xml
<PropertyGroup>
  <Curb_Exe>$(HOME)/.dotnet/tools/curb</Curb_Exe>
</PropertyGroup>

See The build integration for all properties, diagnostics and incremental-build behaviour.

Every GitHub release carries the native binary for each platform: curb-<version>-<rid>.tar.gz for linux-x64, linux-arm64 and osx-arm64, and curb-<version>-<rid>.zip for win-x64 and win-arm64, with a SHA256SUMS file to check them against. Extract it and put curb on PATH. No SDK required to run it — only to install it via dotnet tool.

YAML
- uses: nullean/[email protected]
  with:
    path: .
    command: check      # default; or "format" to rewrite in place
  1. default; a file or directory

Runs curb from a pre-built, distroless container (ghcr.io/nullean/curb) — no .NET SDK install needed in the workflow. The action runs the image built from the ref you pin, so a release pin keeps the formatter fixed until you bump it:

uses: Image
nullean/[email protected] ghcr.io/nullean/curb:0.9.0, that release
nullean/curb@v0 ghcr.io/nullean/curb:v0, the latest 0.x release
nullean/curb@<full commit SHA> the image built from that commit
nullean/curb@main ghcr.io/nullean/curb:edge, the latest commit on main

A ref with no image of its own, such as a commit from before images carried their SHA, runs edge and logs a warning.

command: check fails the job if anything would be reformatted; switch to format to rewrite files instead. Extra flags pass through verbatim via args:

YAML
- uses: nullean/[email protected]
  with:
    command: check
    args: --cache /tmp/curb.cache

Linux runners only (ubuntu-latest and similar) — the action runs a Linux container, which Windows and macOS runners can't host.

ghcr.io/nullean/curb also works as a general-purpose container, outside GitHub Actions — GitLab CI, a local machine without the .NET SDK, anywhere docker run works:

Shell
docker run --rm -v "$(pwd)":/workspace ghcr.io/nullean/curb:edge check /workspace

Distroless: native-AOT, chiseled runtime-deps base, no shell, ~53 MB, runs as a non-root user. Tags follow curb's own releases — edge tracks the latest commit on main; latest, a semver tag (e.g. 0.6.0) and a major tag (e.g. v0) follow tagged releases; and every build is also tagged with its full commit SHA.

Shell
curb --version
Shell
curb check ./src

On a repository already formatted by the IDE, the check should report no changes.