uip config

Syntax and options for `uip config`, which reads, sets, and clears CLI configuration preferences stored in config.json.

uip config reads and writes the CLI's local configuration file — defaults like the output format, log level, and the version/update-channel policy that governs uip update and uip tools update. The file is discovered by walking up from the current directory to $HOME looking for .uipath/config.json, falling back to ~/.uipath/config.json if none is found; --config-file overrides discovery for any verb.

大纲

uip config get [key] [-c <path>]
uip config set <key> <value> [-c <path>]
uip config clear <key> [-c <path>]

All uip config verbs honor the global options (--output, --output-filter, --log-level, --log-file). Exit codes follow the standard contract.

Config keys

密钥	Valid values	Writable	描述
output	table、json、yaml、plain、markdown	是	Default output format for CLI commands.
logLevel	error、warn、info、debug	是	Default log level.
interactive	never, auto, always	是	When the CLI may show interactive prompts. Defaults to auto.
updateChannel	stable, preview (dev is accepted but not advertised)	是	Release channel used to resolve tool updates.
version	major.minor or major.minor.patch (e.g. 1.2 or 1.2.3)	是	Version policy: an exact major.minor.patch freezes auto-update entirely; a major.minor line tracks that line; unset follows the latest release.
clientSecret	—	否	External app client secret used by uip login. Read-only from uip config — set it via uip login --client-secret env.NAME so the secret stays in an environment variable and the auth file, never in config.json.

Two older keys, autoVersionSync and versionSource, were removed when the version policy was collapsed into version + updateChannel. Running uip config set autoVersionSync ... or versionSource ... now fails with Unknown config key, and the error message steers you to the version/updateChannel equivalent.

uip config get

Get one configuration value, or the full configuration when no key is given.

参数

名称	必填	用途
[key]	否	One of the config keys above. Omit to show the entire config file.

选项

• -c, --config-file <path> — path to a specific config file, overriding discovery.

示例

uip config get output

# Show everything
uip config get

数据形状（--输出 json）

单键：

{
  "Code": "ConfigGet",
  "Data": { "Key": "output", "Value": "table" }
}

A key with no value set returns Value: "-". clientSecret (and any other secret-bearing key) always returns <redacted>, never the real value.

No key — the full file, secrets redacted:

{
  "Code": "ConfigList",
  "Data": {
    "Config": {
      "core": { "output": "table", "logLevel": "info", "updateChannel": "stable" },
      "auth": { "clientId": "client-abc", "clientSecret": "<redacted>" }
    }
  }
}

ConfigGet and ConfigList are distinct Code values so a JMESPath consumer sees one stable shape per Code rather than a Data field that changes shape depending on whether key was passed.

uip config set

Set a configuration value.

参数

名称	必填	用途
<key>	是	A writable config key (all of the keys above except clientSecret).
<value>	是	The new value. Validated against the key's allowed values, when it has one.

选项

• -c, --config-file <path> — path to a specific config file, overriding discovery. The file is created if it doesn't exist.

示例

uip config set output table

uip config set updateChannel preview

# Pin the CLI and tools to the 1.196 line (float — tracks patch releases within it)
uip config set version 1.196

# Freeze on an exact patch (no auto-update at all)
uip config set version 1.196.3

数据形状（--输出 json）

{
  "Code": "ConfigSet",
  "Data": { "Key": "output", "Value": "table", "Status": "Updated" }
}

Attempting to set clientSecret fails with ValidationError pointing you to uip login --client-secret env.NAME instead. An invalid value for an enumerated key (for example uip config set output csv) fails with ValidationError and lists the valid values.

uip config clear

Remove a configuration value. A no-op (not an error) if the key was never set.

参数

名称	必填	用途
<key>	是	A writable config key.

选项

• -c, --config-file <path> — path to a specific config file, overriding discovery.

示例

# Un-pin the version so the CLI follows the latest release again
uip config clear version

# Clearing a key that was never set is a no-op
uip config clear updateChannel

数据形状（--输出 json）

{
  "Code": "ConfigClear",
  "Data": { "Key": "version", "Status": "Cleared" }
}

Status is "Not set" instead of "Cleared" when the key had no value to remove.

相关内容

• uip update — config get version / config set version govern which line uip update and uip tools update resolve against.
• uip tools — tool installs/updates read the same version and updateChannel keys.
• uip login — sets credentials outside config.json; clientSecret here is read-only for a reason.

另请参阅

• 全局选项
• 退出代码