config

Manage CLI-wide configuration — read, write, and inspect the settings stored in ~/.celigo/config.json for the active (or a named) profile.

Note: config commands are LOCAL. They do not call the REST API.

celigo config <subcommand> [args] [flags]

Supports all global flags. config reads and writes the active profile by default; pass --profile <name> before the subcommand to target a different profile. Values are persisted to ~/.celigo/config.json (mode 0600).

---

Subcommands

Subcommand	Purpose
show	Dump the profile's full configuration (tokens redacted).
get <key>	Print one configuration value.
set <key> <value>	Write one configuration value.

---

celigo config show

Prints every stored field for the target profile. Any key containing token is redacted. Output respects --format / --jq.

Signature

celigo config show

Arguments

None.

Flags

None (beyond global flags).

Example

celigo config show
celigo --profile ci config show --format json

---

celigo config get

Prints the stored value for one key. If the key is unset, prints <key>: (not set). api_token is redacted on output.

Signature

celigo config get <key>

Arguments

Argument	Type	Required	Description
<key>	string	Yes	One of api_token, base_url, default_format, mode.

Flags

None (beyond global flags).

Example

celigo config get api_token
celigo config get base_url
celigo --profile ci config get mode

---

celigo config set

Writes one key/value pair to the target profile. mode values are validated against the allowed set; other values are stored as provided. The stored value is echoed back on success (with api_token redacted).

Signature

celigo config set <key> <value>

Arguments

Argument	Type	Required	Description
<key>	string	Yes	One of api_token, base_url, default_format, mode.
<value>	string	Yes	New value. For mode, must be read, operate, or full.

Flags

None (beyond global flags).

Example

celigo config set api_token <bearer-token>
celigo config set base_url https://api.eu.integrator.io
celigo config set default_format table
celigo config set mode operate

# Target a non-active profile
celigo --profile ci config set default_format json

---

Gotchas

1. Valid keys are fixed. Only api_token, base_url, default_format, and mode are accepted. Any other key throws Unknown key '<key>'. Valid keys: api_token, base_url, default_format, mode.
2. Writes target one profile at a time. With no --profile flag, config set writes to the active profile. To update a different profile, put --profile <name> before the config subcommand.
3. No config unset. Overwrite with the desired value, or delete the profile with celigo profile delete <name> and recreate it.
4. Tokens are redacted on read, not on write. config set api_token <value> stores the raw token but prints a redacted form; config get api_token and config show always redact.
5. mode is validated. Any value other than read, operate, or full is rejected before it reaches the config file.
6. Env vars and CLI flags override the file. CELIGO_API_TOKEN, CELIGO_BASE_URL, CELIGO_FORMAT, CELIGO_MODE, and the equivalent --token / --base-url / --format / --profile flags take precedence at runtime — writing to the config file does not clear them.

Related

• profile — create, switch, and delete the named profiles that config operates on.
• configuration guide — full reference for the config file schema, environment variables, and precedence rules.