.NET CLI

dotnet

The .NET command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET applications.

Detected by dotnet | macOS, Linux, Windows |learn.microsoft.com

Sync it dotnet.toml

Sync rules

What travels, what stays, what never leaves

Synced2 paths, copied whole to your other machines

~/.nuget/NuGet/NuGet.Config

%APPDATA%/NuGet/NuGet.Config

Secret fieldsInside a file that otherwise syncs

~/.nuget/NuGet/NuGet.Configlines starting with

<add key="ClearTextPassword"<add key="Password"

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

%APPDATA%/NuGet/NuGet.Configlines starting with

<add key="ClearTextPassword"<add key="Password"

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Stays on this machineInside a file that otherwise syncs

~/.nuget/NuGet/NuGet.Configlines starting with <add key="globalPackagesFolder", <add key="repositoryPath"

…

</contoso_x0020_legacy>

</packageSourceCredentials>

<config>

<add key="globalPackagesFolder" value="/Users/octocat/.nuget/packages" />machine-local

<add key="repositoryPath" value="/Users/octocat/src/example/packages" />machine-local

<add key="defaultPushSource" value="https://pkgs.example.com/contoso/nuget/v3/index.json" />

</config>

<packageRestore>

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Stays on this machineInside a file that otherwise syncs

%APPDATA%/NuGet/NuGet.Configlines starting with <add key="globalPackagesFolder", <add key="repositoryPath"

…

</contoso_x0020_legacy>

</packageSourceCredentials>

<config>

<add key="globalPackagesFolder" value="C:\Users\octocat\.nuget\packages" />machine-local

<add key="repositoryPath" value="C:\src\example\packages" />machine-local

</config>

<packageRestore>

<add key="enabled" value="True" />

…

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write. The lines above come from this tool’s test fixture in the catalog.

Excluded2 paths, state rather than configuration — never uploaded

~/.nuget/packages/directory

~/.dotnet/directory

Not a subtraction from the paths above: this is everything else .NET CLI writes in your home directory that is state, not configuration. It keeps a whole-home manager like chezmoi from sweeping those up, and it still holds if the synced paths are ever widened.

.NET CLI in your home directory Every rule on this page, by file

…

</contoso_x0020_legacy>

</packageSourceCredentials>

<config>

<add key="globalPackagesFolder" value="/Users/octocat/.nuget/packages" />machine-local

<add key="repositoryPath" value="/Users/octocat/src/example/packages" />machine-local

<add key="defaultPushSource" value="https://pkgs.example.com/contoso/nuget/v3/index.json" />

</config>

<packageRestore>

…

Each machine keeps its own copy of these.

<add key="ClearTextPassword"<add key="Password"

Lifted into your secret store; the rest of the file syncs.

· packages/ Exclude

· ~/.dotnet/ Exclude

…

</contoso_x0020_legacy>

</packageSourceCredentials>

<config>

<add key="globalPackagesFolder" value="C:\Users\octocat\.nuget\packages" />machine-local

<add key="repositoryPath" value="C:\src\example\packages" />machine-local

</config>

<packageRestore>

<add key="enabled" value="True" />

…

Each machine keeps its own copy of these.

<add key="ClearTextPassword"<add key="Password"

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/dotnet.tomlThe file this page is generated from

id = "dotnet"

name = ".NET CLI"

homepage = "https://learn.microsoft.com/en-us/dotnet/core/tools/"

description = "The .NET command-line interface (CLI) is a cross-platform toolchain for developing, building, running, and publishing .NET applications."

icon = "SimpleIcons:dotnet"

detect = ["dotnet"]

# https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior

# — the user-level NuGet.Config every `dotnet restore`, `dotnet package add`

# and `dotnet nuget` reads and, by default, writes: "Windows:

# %appdata%\NuGet\NuGet.Config Mac/Linux: ~/.config/NuGet/NuGet.Config or

# ~/.nuget/NuGet/NuGet.Config (varies by tooling)". The same page settles which

# of the two Unix spellings belongs here: ".NET CLI uses ~/.nuget/NuGet folder,

# while Mono uses ~/.config/NuGet folder" — so ~/.config/NuGet is Mono's and

# NuGet.exe's, not this entry's.

paths = [

"~/.nuget/NuGet/NuGet.Config",

"%APPDATA%/NuGet/NuGet.Config",

]

# The global packages folder (extracted packages, gigabytes of them) and the

# CLI's own home: first-use sentinels and the binaries of installed global

# tools. Neither is configuration.

exclude = [

"~/.nuget/packages/",

"~/.dotnet/",

]

# No whole-file credential: NuGet.Config is mostly package sources.

secret = []

# Read once per command invocation.

side_effect = false

# `packageSourceCredentials` holds the password for a private feed, either as

# `ClearTextPassword` or as the machine-encrypted `Password`

# (https://learn.microsoft.com/en-us/nuget/reference/nuget-config-file).

# NuGet.Config is XML, which this catalog's key_path syntax does not parse, so

# these are prefix rules — NuGet writes one `<add key=… />` element per line.

# Both spellings, or the password is only lifted out on Unix.

[[secret_paths]]

file = ["~/.nuget/NuGet/NuGet.Config", "%APPDATA%/NuGet/NuGet.Config"]

match = { prefix = ["<add key=\"ClearTextPassword\"", "<add key=\"Password\""] }

# globalPackagesFolder and repositoryPath are absolute paths into this

# machine's disk layout; the same file on another machine needs its own. The

# user relocated them by hand, so the values are kept to set this machine up

# again: backup.

[[machine_lines]]

file = ["~/.nuget/NuGet/NuGet.Config", "%APPDATA%/NuGet/NuGet.Config"]

match = { prefix = ["<add key=\"globalPackagesFolder\"", "<add key=\"repositoryPath\""] }

scope = "backup"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/dotnet. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits <add key="globalPackagesFolder" and <add key="repositoryPath" for you — that part is Otty’s own sync, or a template you write by hand.