config
April 28, 2026 · View on GitHub
Manage agent-cli configuration files.
Usage
agent-cli config [OPTIONS] COMMAND [ARGS]...
Description
The config command helps you create, edit, and inspect your configuration file.
Set AGENT_CLI_CONFIG_HOME or XDG_CONFIG_HOME before startup to change the user-level config path.
Commands
config init- Create a new config templateconfig edit- Open the config file in your editorconfig show- Print the config file path and contents
config init
Create a new config file with all options commented out.
Usage
agent-cli config init [OPTIONS]
Options
| Option | Default | Description |
|---|---|---|
--path, -p | - | Where to create the config file (default: resolved user config path). |
--force, -f | false | Overwrite existing config without prompting for confirmation. |
Example
agent-cli config init
config edit
Open the config file in your default editor.
Usage
agent-cli config edit [OPTIONS]
Options
| Option | Default | Description |
|---|---|---|
--path, -p | - | Override auto-detection and use this config file path. |
Example
agent-cli config edit
config show
Display the config file location and contents.
Usage
agent-cli config show [OPTIONS]
Options
| Option | Default | Description |
|---|---|---|
--path, -p | - | Override auto-detection and use this config file path. |
--raw, -r | false | Print plain file contents without syntax highlighting or line numbers. |
--json | false | Output as JSON with path, exists, and content fields. |
Example
agent-cli config show --raw