Configuration

Config file location

Priority	Source
1	--config flag
2	SP_CONFIG environment variable
3	~/.config/softprobe/config.yaml

Example file

current-profile: default

profiles:
  default:
    url: http://127.0.0.1:8090
    token: ""   # optional; prefer SP_TOKEN in CI

  staging:
    url: https://sp-staging.example.com
    token: ""

  prod:
    url: https://sp.example.com
    # token omitted — use SP_TOKEN from secret manager

Environment overrides

Variable	Overrides
SP_API_URL	Profile url
SP_TOKEN	Profile token
SP_PROFILE	Active profile name

CLI flags take precedence over environment:

sp --api-url http://localhost:8090 --profile staging app list --json

Commands

Command	Action
sp config init	Create default config file
sp config show	Print resolved URL and profile (mask token)
sp config set-url <url>	Update current profile URL
sp config set-profile <name>	Switch profile

TLS and proxies

• Use https:// URLs in production profiles.
• Standard Go HTTP_PROXY / HTTPS_PROXY apply to the CLI HTTP client.
• Custom CA bundles: implementer may support SP_CA_FILE (optional future flag).

Security

• File mode 0600 recommended for config containing tokens.
• Prefer SP_TOKEN in CI over writing tokens to disk.
• sp config show must never print full token — only token: *** or last four characters.

Related

• Authentication
• config command