Skip to main content

Commands Overview

The CLI exposes all DevOps AI Toolkit server capabilities as commands. Commands are automatically generated from the server's OpenAPI specification.

Discovering Commands​

To see all available commands:

dot-ai --help

To see help for a specific command:

dot-ai <command> --help

For details on what each feature does, see the server documentation.

Global Flags​

These flags work with all commands:

FlagEnvironment VariableDescription
--server-urlDOT_AI_URLServer URL (default: http://localhost:3456)
--tokenDOT_AI_AUTH_TOKENAuthentication token
--outputDOT_AI_OUTPUT_FORMATOutput format: yaml or json (default: yaml)
--help-Show command help

Config Command​

Manage persistent settings stored in ~/.config/dot-ai/settings.json:

dot-ai config set <key> <value>   # Set a value
dot-ai config get <key>           # Get a value
dot-ai config list                # List all keys and values
dot-ai config reset <key>         # Reset to default

See Configuration for supported keys and details.

Usage Patterns​

Basic command execution:

dot-ai <command> [arguments] [flags]

With output format:

dot-ai <command> --output json

Remote server:

dot-ai <command> --server-url https://remote:3456 --token mytoken

Piping output:

dot-ai <command> --output json | jq '.result'

Next Steps​