id       = "jfrog-cli"
name     = "JFrog CLI"
homepage = "https://docs.jfrog.com/integrations/docs/configuring-the-cli"
description = "JFrog CLI is a command-line interface for JFrog products and services."
executables   = ["jf"]

[dotfiles]

# https://docs.jfrog.com/integrations/docs/configuring-the-cli documents the
# default CLI home as ~/.jfrog and names jfrog-cli.conf.v6 as the JSON file
# containing server configurations and credentials. The directory also holds
# plugin/dependency caches and transfer state, which are intentionally omitted.
paths = []
secret = ["~/.jfrog/jfrog-cli.conf.v6"]
side_effect = false

[commands]
format = 1
label = "JFrog CLI"
description = "Configure and select JFrog servers and ping Artifactory. Access tokens and passwords are deliberately not fields; add credentials interactively."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["config", "add"]
label = "Add a server"
description = "Save a JFrog Platform server configuration. Leave interactive on so the CLI prompts for credentials."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://docs.jfrog.com/integrations/docs/configuring-the-cli"
revision = "2026-10-27"
evidence = """
jf config add myserver \
  --url=https://mycompany.jfrog.io \
  --access-token=<your-access-token> \
  --interactive=false
"""

[[commands.subcommand.field]]
id = "server_id"
label = "Server ID"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.field]]
id = "url"
label = "Platform URL"
type = "url"
option = ["--url"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "add"
label = "Add a server"
fields = ["server_id", "url"]
required = ["server_id"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["server_id", "url"]

[[commands.subcommand]]
path = ["config", "use"]
label = "Select the default server"
description = "Make a saved server the default for later commands."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://docs.jfrog.com/integrations/docs/configuring-the-cli"
revision = "2026-10-27"
evidence = """
jf config use myserver
jf config use <server-id>
"""

[[commands.subcommand.field]]
id = "server_id"
label = "Server ID"
type = "string"
position = 0
sources = ["docs"]

[[commands.subcommand.task]]
id = "use"
label = "Use server"
fields = ["server_id"]
required = ["server_id"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["server_id"]

[[commands.subcommand]]
path = ["rt", "ping"]
label = "Ping Artifactory"
description = "Check that a configured Artifactory server responds."

[[commands.subcommand.source]]
id = "docs"
kind = "manual"
url = "https://docs.jfrog.com/integrations/docs/configuring-the-cli"
revision = "2026-10-27"
evidence = """
jf rt ping
jf rt ping --server-id=dev-server
"""

[[commands.subcommand.field]]
id = "server_id"
label = "Server ID"
description = "Uses the default server when empty."
type = "string"
option = ["--server-id"]
sources = ["docs"]

[[commands.subcommand.task]]
id = "ping"
label = "Ping"
fields = ["server_id"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["server_id"]