03 / CLI Reference

CLI Reference

The omega command-line tool for managing services, deployments, and configuration.

Installation

# npm
npm install -g @omegadigital/cli

# Homebrew (macOS / Linux)
brew install omegadigital/tap/omega

# Verify
omega --version
# omega/2.4.1 linux-x64 node-v22.0.0

omega login

Authenticate the CLI with your Omega Digital account.

Usage

omega login [--token <api-key>]

Flags

Flag	Description
`--token <key>`	Non-interactive login using an API key. Useful for CI/CD pipelines.
`--region <region>`	Set the default region for subsequent commands (e.g. us-east, eu-west).

Examples

Interactive browser-based login

omega login
# Opens browser → authorize → token saved to ~/.omega/credentials

Non-interactive with API key (CI/CD)

export OMEGA_API_KEY=sk_live_...
omega login --token $OMEGA_API_KEY

omega deploy

Deploy an application to a service. Supports Node.js, static sites, Docker images, and git repos.

Usage

omega deploy [--service <id>] [--env <name>] [options]

Flags

Flag	Description
`--service <id>`	Target service ID. Defaults to the service linked in .omega.json.
`--env <name>`	Target environment: production (default), staging, or preview.
`--build <cmd>`	Override the build command defined in .omega.json.
`--no-build`	Skip build step; deploy artifact as-is.
`--rollback`	Roll back to the previous deployment immediately.
`--watch`	Stream deployment logs until completion.

Examples

Deploy current directory (reads .omega.json)

omega deploy --watch

Deploy to staging with a custom build command

omega deploy --service svc_01HY7M3ABCXYZ \
  --env staging \
  --build "npm run build:staging" \
  --watch

Roll back production to previous release

omega deploy --rollback --env production

omega services list

List all services on the account with their current status, IP, and region.

Usage

omega services list [--json] [--filter <status>]

Flags

Flag	Description
`--json`	Output as JSON instead of the default table.
`--filter <status>`	Filter by status: running, stopped, provisioning, error.
`--region <region>`	Show only services in the specified region.

Examples

List all services as a table

omega services list

# ID                    TYPE   LABEL          REGION     IP               STATUS
# svc_01HY7M3ABCXYZ    vps    prod-web-01    us-east    198.51.100.42    running
# svc_02JZ9N4CDEXYZ    vps    staging-01     us-west    203.0.113.5      running

Output as JSON for scripting

omega services list --json | jq '.[].ipv4'

omega logs

Stream or tail application and system logs from a service.

Usage

omega logs <service-id> [--lines <n>] [--follow] [--since <duration>]

Flags

Flag	Description
`--lines <n>`	Number of historical lines to show before streaming. Default: 100.
`--follow, -f`	Keep connection open and stream new log lines in real time.
`--since <duration>`	Show logs from the last duration (e.g. 1h, 30m, 2d).
`--type <type>`	Filter by log type: app (default), nginx, mysql, system.

Examples

Stream live application logs

omega logs svc_01HY7M3ABCXYZ --follow

Show last 500 nginx error log lines from the past hour

omega logs svc_01HY7M3ABCXYZ \
  --type nginx \
  --lines 500 \
  --since 1h

omega ssh

Open an interactive SSH session to a service using your stored keys.

Usage

omega ssh <service-id> [--user <username>] [-- <remote-command>]

Flags

Flag	Description
`--user <username>`	SSH user. Defaults to root for fresh VPS, deploy for managed deployments.
`--key <path>`	Path to SSH private key. Defaults to the key registered in the control panel.
`-- <command>`	Run a single command on the remote server instead of opening a shell.

Examples

Interactive shell

omega ssh svc_01HY7M3ABCXYZ

Run a remote command without opening a shell

omega ssh svc_01HY7M3ABCXYZ -- "systemctl status nginx"

Connect as a specific user

omega ssh svc_01HY7M3ABCXYZ --user deploy

omega env

Manage environment variables for a service. Changes take effect on next deploy.

Usage

omega env <set|get|list|delete> [service-id] [KEY[=VALUE]]

Flags

Flag	Description
`--service <id>`	Target service. Can also be set via .omega.json.
`--env <name>`	Target environment (production, staging). Default: production.
`--from-file <path>`	Import variables from a .env file.

Examples

Set a single environment variable

omega env set --service svc_01HY7M3ABCXYZ DATABASE_URL=postgres://...

Import from a .env file

omega env set --service svc_01HY7M3ABCXYZ --from-file .env.production

List all env vars (values masked)

omega env list --service svc_01HY7M3ABCXYZ

# KEY              VALUE
# NODE_ENV         production
# DATABASE_URL     postgres://***
# API_SECRET       ****

Delete a variable

omega env delete --service svc_01HY7M3ABCXYZ OLD_API_KEY