CLI Reference

Comprehensive reference for the azenth command-line interface. The CLI provides programmatic access to Aevum Zenth's global infrastructure, deployment pipelines, and enterprise resource management systems.

ℹ️ Note

CLI v3.2+ requires Node.js 18+ or Python 3.10+. Legacy v2.x commands are deprecated and will reach EOL on 2026-09-01.

Installation

Install the CLI globally using npm, yarn, or direct binary download.

npm

npm install -g @aevumzenth/cli

yarn

yarn global add @aevumzenth/cli

Verify installation:

Terminal

azenth --version
# Output: 3.2.1 (build 8f4a2c)

Authentication

The CLI supports OAuth2 device flow, API keys, and enterprise SSO. Run azenth auth login to initiate authentication. Tokens are cached in ~/.azenth/config.yaml.

Core Commands

azenth init [project-name]

Scaffolds a new project with pre-configured CI/CD pipelines, infrastructure templates, and division-specific presets.

Options

Flag	Type	Description
--division	`string`	Target division preset (energy, tech, aerospace, healthcare, finance, etc.)
--template	`string`	Base template URL or registry ID
--force	`boolean`	Overwrite existing directory

Example

azenth init quantum-grid --division=energy --template=enterprise-v3

azenth deploy [environment]

Builds and deploys the current project to the specified Aevum Zenth environment. Supports zero-downtime rolling updates and canary releases.

Options

Flag	Type	Description
--region	`string`	Deployment region (us-east-1, eu-west, ap-south, etc.)
--replicas	`number`	Instance count override
--canary	`percentage`	Route traffic percentage for staged rollout
--dry-run	`boolean`	Validate deployment manifest without executing

Example

azenth deploy production --region=eu-west --canary=20% --wait

azenth logs [service] [flags]

Streams real-time operational logs from Aevum Zenth's distributed logging infrastructure. Supports structured JSON output and filter expressions.

Options

Flag	Type	Description
--follow	`boolean`	Stream logs continuously (default: true)
--since	`duration`	Time window (e.g., 5m, 2h, 24h)
--level	`string`	Filter by severity (debug, info, warn, error, fatal)
--json	`boolean`	Output raw JSON payloads

azenth config get|set|list [key]

Manage local and project-level configuration. Settings cascade: CLI env vars → global config → project config.

Examples

azenth config set default_region ap-northeast-1
azenth config get auth.token_expiry
azenth config list --format=table

azenth status [service]

Queries health endpoints, resource utilization, and deployment state across active environments. Integrates with Zenth Observability Mesh.

Global Flags

Available across all commands.

Flag	Description
`--verbose, -v`	Enable debug logging to stderr
`--quiet, -q`	Suppress all non-error output
`--format`	Output format: `table`, `json`, `yaml`
`--no-color`	Disable terminal ANSI coloring
`--profile`	Use named configuration profile

Environment Variables

Variable	Description	Default
`AZENTH_CONFIG_DIR`	Override default config path	`~/.azenth`
`AZENTH_LOG_LEVEL`	Global log verbosity	`info`
`AZENTH_DISABLE_TELEMETRY`	Opt-out of usage metrics	`false`
`AZENTH_PROXY_URL`	HTTP/HTTPS proxy for API calls	`null`

Exit Codes

Code	Meaning
`0`	Success
`1`	General error or invalid input
`2`	Authentication failure or expired token
`3`	Network timeout or API unreachable
`4`	Insufficient permissions / RBAC denied
`5`	Deployment validation failed

Troubleshooting

Common Issues

"ETIMEDOUT: api.azenth.com unreachable"
Verify network policy allowances. The CLI requires outbound HTTPS on ports 443 and 8443. Corporate firewalls may block Zenth CDN ranges. Use --proxy if behind a gateway.

"Token refresh failed"
Credentials cached beyond 24h require re-authentication. Run azenth auth refresh or azenth auth login.

"Division preset not found"
Ensure your tenant has access to the requested division registry. Contact your Aevum Zenth account manager for cross-division entitlements.

Missing a command or flag? Report an issue on GitHub or submit feedback via azenth feedback.