Flags & Options

Global flags available on all NexusCore CLI commands.

Global Flags

Flag	Short	Description
--help	-h	Show help for a command
--version	-v	Print the CLI version
--verbose		Enable verbose output (debug logging)
--quiet	-q	Suppress non-essential output
--config <path>		Path to config file (default: ~/.nexuscore/config.yaml)
--no-color		Disable colored output
--json		Output in JSON format (where supported)

Usage Examples

# Show help for a specific command
nexus-cli auth login --help

# Print version
nexus-cli --version

# Run with verbose output
nexus-cli chat --verbose

# Suppress non-essential output
nexus-cli run "Create a test file" --quiet

# Use a custom config file
nexus-cli chat --config ./my-config.yaml

# Output in JSON (useful for scripting)
nexus-cli models list --json
nexus-cli auth status --json

Environment Variables

Global behavior can also be controlled via environment variables. Environment variables take precedence over config file values but are overridden by command-line flags.

General

Variable	Description	Default
NEXUS_CONFIG	Path to config file	~/.nexuscore/config.yaml
NEXUS_VERBOSE	Enable verbose output (1 or 0)	0
NEXUS_NO_COLOR	Disable colored output (1 or 0)	0
NEXUS_LOG_LEVEL	Log level (debug, info, warn, error)	info

Model Configuration

Variable	Description	Default
NEXUS_MODEL_PROVIDER	Default model provider name	—
NEXUS_API_KEY	API key for the default provider	—
NEXUS_MODEL	Default model name	—
NEXUS_BASE_URL	Custom API base URL for the default provider	—
OPENAI_API_KEY	OpenAI API key	—
ANTHROPIC_API_KEY	Anthropic API key	—
GOOGLE_API_KEY	Google AI API key	—

Authentication

Variable	Description	Default
NEXUS_AUTH_URL	Auth service URL	https://api.nexus-suite.dev
NEXUS_TOKEN	JWT token (for CI/automation — bypasses interactive login)	—

Sync

Variable	Description	Default
NEXUS_SYNC_ENABLED	Enable encrypted sync (1 or 0)	0

Precedence Order

Configuration is resolved in this order (highest priority first):

1. Command-line flags — --model, --verbose, etc.
2. Environment variables — NEXUS_MODEL, NEXUS_VERBOSE, etc.
3. Project-level config — .nexuscore/config.yaml in the current workspace
4. User-level config — ~/.nexuscore/config.yaml
5. Built-in defaults