otty / dotfiles

All tools/Netlify CLI

Netlify CLI

netlify

Interact with Netlify from the comfort of your CLI.

Detected by netlify, ntl | macOS, Linux, Windows |cli.netlify.com

Sync it netlify.toml

Sync rules

What travels, what stays, what never leaves

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

{

"cliId": "3f9c1d2e-FAKE-4a5b-8c7d-1e2f3a4b5c6d",machine-local

"telemetryDisabled": true,

"userId": "5a4b3c2d1e0f9a8b7c6d5e4f",

"users": {

…

Each machine keeps its own copy of these.

users.*.auth.tokenusers.*.auth.github.token

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

{

"cliId": "3f9c1d2e-FAKE-4a5b-8c7d-1e2f3a4b5c6d",machine-local

"telemetryDisabled": true,

"userId": "5a4b3c2d1e0f9a8b7c6d5e4f",

"users": {

…

Each machine keeps its own copy of these.

users.*.auth.tokenusers.*.auth.github.token

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

{

"cliId": "3f9c1d2e-FAKE-4a5b-8c7d-1e2f3a4b5c6d",machine-local

"telemetryDisabled": true,

"userId": "5a4b3c2d1e0f9a8b7c6d5e4f",

"users": {

…

Each machine keeps its own copy of these.

users.*.auth.tokenusers.*.auth.github.token

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/netlify.tomlThe file this page is generated from

id = "netlify"

name = "Netlify CLI"

homepage = "https://cli.netlify.com"

description = "Interact with Netlify from the comfort of your CLI."

icon = "SimpleIcons:netlify"

detect = ["netlify", "ntl"]

# https://docs.netlify.com/api-and-cli-guides/cli-guides/get-started-with-cli/

# — "Netlify CLI stores your access token in a config.json global

# configuration file", located at Library/Preferences/netlify/config.json on

# macOS, .config/netlify/config.json on Linux and

# AppData\Roaming\netlify\Config\config.json on Windows. That is env-paths's

# layout: src/lib/settings.ts does `envPaths('netlify', { suffix: '' })` and

# reads config.json from its .config directory.

paths = [

"~/Library/Preferences/netlify/config.json",

"~/.config/netlify/config.json",

"%APPDATA%/netlify/Config/config.json",

]

exclude = []

# config.json is not a whole-file secret: the account list, the telemetry

# choice and the user's name and email are ordinary settings. Only the tokens

# are lifted out.

secret = []

# Every spelling, or the token is lifted out on one platform and syncs in the

# clear from the others. The shape is the one storeToken() writes in

# src/commands/base-command.ts:

# globalConfig.set(`users.${userId}`, { id, name, email,

# auth: { token, github: { user, token } } })

# — the Netlify access token and, once a site is linked through `netlify init`,

# the GitHub token beside it.

[[secret_paths]]

file = [

"~/Library/Preferences/netlify/config.json",

"~/.config/netlify/config.json",

"%APPDATA%/netlify/Config/config.json",

]

match = { key_path = ["users.*.auth.token", "users.*.auth.github.token"] }

# cliId is the anonymous install identifier the CLI generates once and reports

# as telemetry's anonymousId (src/utils/telemetry/telemetry.ts), so carrying it

# to a second machine would make the two report as one install.

[[machine_lines]]

file = [

"~/Library/Preferences/netlify/config.json",

"~/.config/netlify/config.json",

"%APPDATA%/netlify/Config/config.json",

]

match = { key_path = ["cliId"] }

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/netlify. 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 cliId and cliId for you — that part is Otty’s own sync, or a template you write by hand.