id          = "auth0"
name        = "Auth0 CLI"
homepage    = "https://github.com/auth0/auth0-cli"
description = "Build, manage and test your Auth0 integrations from the command-line"
executables      = ["auth0"]

[dotfiles]

# The official source's defaultPath() is $HOME/.config/auth0/config.json.
# It stores authenticated tenants and access tokens in that JSON file.
# https://github.com/auth0/auth0-cli/blob/main/internal/config/config.go
paths  = []
secret = ["~/.config/auth0/config.json"]

[commands]
format = 1
label = "Auth0 CLI"
description = "Sign in with machine credentials and list applications. Other Auth0 commands are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["login"]
label = "Log in with client credentials"
description = "Machine login for servers and CI. The client secret is typed into the command line, so prefer an interactive login on shared machines."

[[commands.subcommand.source]]
id = "login"
kind = "help"
url = "https://github.com/auth0/auth0-cli/blob/main/docs/auth0_login.md"
revision = "main 2026-10-27"
evidence = """
      --client-id string                      Client ID of the application when authenticating via client credentials.
      --client-secret string                  Client secret of the application when authenticating via client credentials.
      --domain string                         Tenant domain of the application when authenticating via client credentials.
      --scopes strings                        Additional scopes to request when authenticating via device code flow.
"""

[[commands.subcommand.field]]
id = "domain"
label = "Tenant domain"
type = "string"
option = ["--domain"]
sources = ["login"]

[[commands.subcommand.field]]
id = "client_id"
label = "Client ID"
type = "string"
option = ["--client-id"]
sources = ["login"]

[[commands.subcommand.field]]
id = "client_secret"
label = "Client secret"
type = "string"
option = ["--client-secret"]
sources = ["login"]

[[commands.subcommand.task]]
id = "machine"
label = "Machine login"
fields = ["domain", "client_id", "client_secret"]
required = ["domain", "client_id", "client_secret"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["domain", "client_id", "client_secret"]

[[commands.subcommand]]
path = ["apps", "list"]
label = "List applications"

[[commands.subcommand.source]]
id = "list"
kind = "help"
url = "https://github.com/auth0/auth0-cli/blob/main/docs/auth0_apps_list.md"
revision = "main 2026-10-27"
evidence = """
      --csv              Output in csv format.
      --json             Output in json format.
      --json-compact     Output in compact json format.
  -n, --number int       Number of apps to retrieve. Minimum 1, maximum 1000. (default 100)
  -r, --reveal-secrets   Display the application secrets ('signing_keys', 'client_secret') as part of the command output.
      --tenant string   Specific tenant to use.
"""

[[commands.subcommand.field]]
id = "number"
label = "Number of apps"
type = "integer"
option = ["--number", "-n"]
sources = ["list"]

[[commands.subcommand.field]]
id = "reveal"
label = "Reveal secrets"
type = "boolean"
option = ["--reveal-secrets", "-r"]
sources = ["list"]

[[commands.subcommand.field]]
id = "json"
label = "JSON output"
type = "boolean"
option = ["--json"]
sources = ["list"]

[[commands.subcommand.field]]
id = "csv"
label = "CSV output"
type = "boolean"
option = ["--csv"]
sources = ["list"]

[[commands.subcommand.field]]
id = "tenant"
label = "Tenant"
type = "string"
option = ["--tenant"]
sources = ["list"]

[[commands.subcommand.task]]
id = "list"
label = "List apps"
fields = ["number", "json", "csv", "tenant"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["number", "json", "csv", "tenant", "reveal"]