Skip to content
GitLab

akili config

Manage the CLI configuration. The configuration file stores API URLs, active profiles, and other settings. Tokens are stored in a separate file with restricted permissions.

Configuration file location: ~/.config/akili/config.toml

Initialize a new configuration file with a default profile.

Flags:

FlagShortDefaultDescription
--api-urlhttp://localhost:8080API URL for the profile
--profiledefaultProfile name to create

Examples:

Terminal window
# Initialize with defaults (localhost)
akili config init
# Initialize with a production URL
akili config init --api-url https://api.akili.systems
# Initialize a named profile
akili config init --api-url https://staging-api.akili.systems --profile staging

Display the current CLI configuration, including the active profile, API URL, token status, timeout, and file paths.

Examples:

Terminal window
# Show current config
akili config show
# Output:
# Profile: default
# API URL: https://api.akili.systems
# Token: configured
# Timeout: 30s
#
# Config: /home/user/.config/akili/config.toml
# Tokens: /home/user/.config/akili/tokens

Set the active profile in the configuration file. The profile must already exist in config.toml.

Arguments:

ArgumentTypeRequiredDescription
namestringyesProfile name to activate

Examples:

Terminal window
# Switch to staging profile
akili config set-profile staging
# Switch back to default
akili config set-profile default

If no configuration file exists, the command will suggest running akili config init first.


Print the configuration file path to stdout.

Examples:

/home/user/.config/akili/config.toml
# Show config path
akili config path
# Open in editor
$EDITOR $(akili config path)
# Active profile selection
active_profile = "default"
# Default profile
[default]
api_url = "https://api.akili.systems"
# Named profiles
[profiles.staging]
api_url = "https://staging-api.akili.systems"
[profiles.local]
api_url = "http://localhost:8080"

Use the --profile global flag to override the active profile for a single command:

Terminal window
# Use staging profile for this command only
akili --profile staging product list
# The active profile in config.toml is not changed

For CI/CD environments, use environment variables instead of profiles:

Terminal window
export AKILI_API_URL="https://api.akili.systems"
export AKILI_TOKEN="akt_..."
akili product list