otty / apps

All apps/Fastly CLI

Fastly CLI

fastly

Build, deploy and configure Fastly services from your terminal.

Runs as fastly|macOS, Linux, Windows|www.fastly.com

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

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

auth.tokens.*.tokenauth.tokens.*.access_tokenauth.tokens.*.refresh_tokenprofile.*.tokenprofile.*.access_tokenprofile.*.refresh_token

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

auth.tokens.*.tokenauth.tokens.*.access_tokenauth.tokens.*.refresh_tokenprofile.*.tokenprofile.*.access_tokenprofile.*.refresh_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/fastly/otty.tomlThe file this page is generated from

id = "fastly"

name = "Fastly CLI"

homepage = "https://www.fastly.com/documentation/reference/cli/"

description = "Build, deploy and configure Fastly services from your terminal."

icon = "SimpleIcons:fastly"

executables = ["fastly"]

[dotfiles]

# pkg/config/config.go: FileName = "config.toml" and FilePath is

# os.UserConfigDir()/fastly/config.toml, falling back to <home>/.fastly/config.toml

# when the OS cannot report a user config directory. os.UserConfigDir() is the

# [appData] base directory — ~/Library/Application Support on macOS, the XDG

# config home on Linux, %APPDATA% on Windows; the second entry is the fallback,

# listed so the rule below reaches it.

paths = [

"[appData]/fastly/config.toml",

"~/.fastly/config.toml",

]

exclude = []

# Not a whole-file secret: the same file holds the API endpoints, the language

# toolchain settings and the wasm-metadata opt-ins, all worth carrying.

secret = []

# Read at the start of each command; nothing holds it open.

side_effect = false

# pkg/config/auth.go AuthToken: `token` for a static API token and

# `access_token` / `refresh_token` for an SSO session, under [auth.tokens.<name>].

# pkg/config/config.go Profile is the legacy [profile.<name>] shape with the same

# three fields. Both spellings of the file are named, or the tokens sync in the

# clear from a machine that fell back to ~/.fastly.

[[dotfiles.secret_paths]]

file = [

"[appData]/fastly/config.toml",

"~/.fastly/config.toml",

]

match = { key_path = [

"auth.tokens.*.token",

"auth.tokens.*.access_token",

"auth.tokens.*.refresh_token",

"profile.*.token",

"profile.*.access_token",

"profile.*.refresh_token",

] }

# No machine_lines: nothing the CLI writes here names this machine — the

# endpoints are Fastly's, and the language settings are toolchain versions.

[commands]

format = 1

label = "Fastly"

description = "Purge cache, build and deploy Compute packages. Everything else is left out."

quality = "ai-draft"

base = "fig:fastly"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fastly.ts"

license = "MIT"

[[commands.subcommand]]

path = ["purge"]

label = "Purge cache"

description = "Pick exactly one of URL, key or all."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fastly.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "service_id"

label = "Service ID"

type = "string"

option = ["--service-id"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "url"

label = "URL"

type = "string"

option = ["--url"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "key"

label = "Surrogate key"

type = "string"

option = ["--key"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "all"

label = "Purge everything"

type = "boolean"

option = ["--all"]

effect = "delete"

sources = ["fig"]

[[commands.subcommand.field]]

id = "soft"

label = "Soft purge"

type = "boolean"

option = ["--soft"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "url"

label = "Purge a URL"

fields = ["service_id", "url", "soft"]

required = ["url"]

[[commands.subcommand.task]]

id = "key"

label = "Purge a key"

fields = ["service_id", "key", "soft"]

required = ["key"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["service_id", "url", "key", "all"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["soft"]

[[commands.subcommand]]

path = ["compute", "build"]

label = "Build Compute package"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fastly.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "name"

label = "Package name"

type = "string"

option = ["--name"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "language"

label = "Language"

type = "string"

option = ["--language"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "include_source"

label = "Include source"

type = "boolean"

option = ["--include-source"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "timeout"

label = "Timeout (s)"

type = "integer"

option = ["--timeout"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "skip_verification"

label = "Skip verification"

type = "boolean"

option = ["--skip-verification"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "build"

label = "Build"

fields = ["name", "language"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["name", "language", "include_source"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["timeout", "skip_verification"]

[[commands.subcommand]]

path = ["compute", "deploy"]

label = "Deploy Compute package"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/fastly.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "service_id"

label = "Service ID"

type = "string"

option = ["--service-id"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "service_name"

label = "Service name"

type = "string"

option = ["--service-name"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "package"

label = "Package"

type = "path"

option = ["--package"]

path = { kind = "file", role = "input" }

sources = ["fig"]

[[commands.subcommand.field]]

id = "comment"

label = "Comment"

type = "string"

option = ["--comment"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "domain"

label = "Domain"

type = "string"

option = ["--domain"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "version"

label = "Version"

type = "string"

option = ["--version"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "deploy"

label = "Deploy"

fields = ["service_id", "package", "comment"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["service_id", "service_name", "package", "comment"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["version", "domain"]

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/fastly. 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.