Config Commands

The config group lets you inspect and manage the active acp2md configuration without editing YAML by hand.

These commands are especially useful on managed workstations, CI runners, or support sessions where you want repeatable setup steps and an auditable configuration workflow.

config create

Creates a new config file at the default location, pre-filled with all available settings and their default values.


acp2md config create

If a config file already exists, the command will not overwrite it. Delete the existing file first if you want to reset to defaults.

config where

Prints the full path to the active config file.


acp2md config where

Example output:


/Users/alice/Library/Application Support/acp2md/config.yaml

Use this to find the file and open it in your editor.

config list

Displays all current configuration values, including those loaded from environment variables and CLI flags.


acp2md config list

Use this when you need to understand the effective configuration rather than only the values stored in config.yaml.

config get

Retrieves the value of a single configuration key.


acp2md config get KEY

Examples


acp2md config get confluence.domain
acp2md config get log.level
acp2md config get http.client.max_retries

config set

Sets a configuration value and saves it to the config file.


acp2md config set KEY VALUE

Examples


# Confluence credentials
acp2md config set confluence.domain mycompany.atlassian.net
acp2md config set confluence.username you@example.com
acp2md config set confluence.api_token YOUR_API_TOKEN
 
# Logging
acp2md config set log.level debug
acp2md config set log.format json
acp2md config set log.file /var/log/acp2md.log
 
# HTTP
acp2md config set http.client.max_retries 5
acp2md config set http.client.proxy "http://proxy.corp.example.com:8080"
 
# Images
acp2md config set image.cache_dir /tmp/acp2md-cache
acp2md config set image.max_size_bytes 20971520

Available config keys

Key	Description
`confluence.domain`	Confluence instance domain
`confluence.username`	Atlassian account email
`confluence.api_token`	Confluence API token
`http.client.max_retries`	Number of HTTP retry attempts
`http.client.base_timeout`	Base request timeout (e.g. `10ms`)
`http.client.max_timeout`	Max request timeout (e.g. `100ms`)
`http.client.proxy`	HTTP proxy URL
`log.level`	Log level: `debug`, `info`, `warn`, `error`
`log.format`	Log format: `text`, `json`
`log.file`	Log output: `stdout`, `stderr`, or a file path
`debug.enabled`	Enable debug mode (`true` / `false`)
`image.cache_dir`	Directory for caching downloaded images
`image.max_size_bytes`	Maximum image size in bytes

Recommended workflow

run acp2md config create
set the Confluence connection values with config set
confirm them with config get or config list
run acp2md doctor