CLI Tools

Operate AeThex from the command line

The AeThex CLI automates local development, environment management, and production deployments. It is built with stability in mind, featuring transactional deploys, shell-friendly output, and native support for Linux, macOS, and Windows.

Command Catalog

Command	Description	Usage Notes
aethex init [name]	Scaffold a new project with opinionated defaults	Creates configuration, environments, and starter services
aethex login	Authenticate the CLI with your AeThex identity	Support for browser-based login and personal access tokens
aethex deploy	Build and deploy the current project	Runs tests, packages artifacts, and promotes to the target environment
aethex env pull	Sync environment variables and secrets	Keeps local .env files mirrored with the dashboard
aethex pipeline logs	Stream deployment logs in real time	Supports filters by environment, branch, or commit SHA

Run aethex --help for the full command tree.

Local Development

Develop and test locally with hot reloading, mocked services, and seeded sample data.

aethex dev

Features:

• Live reload on file changes

• Mock API responses for testing

• Local database snapshots

• Development SSL certificates

Environment Management

Pull secrets and configuration from your AeThex dashboard:

aethex env pull

Production Deployment

Build and deploy to production environments:

aethex deploy

Features:

• Automated testing

• Build artifact caching

• Transactional deployments

• Automatic rollback on failure

Automation Tips

GitHub Actions

Use the official AeThex GitHub Action to authenticate, run smoke tests, and deploy on every pull request merge.

Audit Trails

Every CLI deployment emits audit events. Stream them into your SIEM through the webhooks integration.

Rollbacks

Instantly revert to the previous stable release and notify collaborators:

aethex deploy --rollback latest

Preview Environments

Spin up disposable stacks tied to feature branches for stakeholder reviews:

aethex preview create

Configuration

Configure your project in aethex.config.ts:

export default {
  name: "my-project",
  region: "us-central",
  runtime: "node18",
  environments: {
    staging: {
      domain: "staging.example.com",
    },
    production: {
      domain: "app.example.com",
    },
  },
};

Troubleshooting

• Check logs with aethex pipeline logs

• Verify authentication with aethex whoami

• Test configuration with aethex validate