Configuration
ActionXM CLI stores its configuration in a JSON file at ~/.config/actionxm/config.json.
Config file location
| OS | Path |
|---|---|
| Linux | ~/.config/actionxm/config.json |
| macOS | ~/.config/actionxm/config.json |
| Windows | %USERPROFILE%\.config\actionxm\config.json |
Config keys
| Key | Type | Default | Description |
|---|---|---|---|
api_url | string | http://localhost:3002 | ActionXM API server URL |
access_token | string | — | JWT authentication token |
current_site_id | string | — | Active site UUID |
current_site_name | string | — | Active site display name |
user | object | — | Cached user profile |
sites | array | — | Cached site list |
File permissions
The config file is created with 0600 permissions (owner read/write only) to protect the stored access token.
Modifying configuration
Use the actionxm config commands:
bash
# View all settings
actionxm config list
# Get a specific value
actionxm config get api_url
# Set a value
actionxm config set api_url https://analytics.yourcompany.com
# Show file path
actionxm config pathWARNING
Do not manually edit the config file while the CLI is running. Use actionxm config set instead.