CLI

The edge CLI is the command-line interface for Simplifyd Cloud. It mirrors every operation available in the web dashboard and is designed for both interactive development and automated CI/CD pipelines.

Installation

brew install simplifyd-systems/tap/edge

go install github.com/simplifyd-systems/cloud-cli/cmd/edge@latest

git clone https://github.com/simplifyd-systems/cloud-cli
cd cloud-cli
make build    # outputs bin/edge
make install  # installs to $GOPATH/bin

Authentication

Log in interactively:

edge auth login

You will be prompted for your email and password. The JWT is stored in ~/.simplifyd/config.json.

Token-based authentication

For non-interactive environments (CI/CD, scripts), use a token instead:

The CLI picks the first token it finds in this order. This lets you override the stored token on a per-command basis without touching your config file.

Context resolution

Most commands need a workspace, project, and environment to know what to operate on. The CLI resolves context in this order:

1. Explicit flags — --workspace/-w, --project/-p, --env/-e
2. .edge.json link file — created by edge link in your project directory (walks up the directory tree)
3. Global config — active_workspace, active_project, active_env set by edge workspace use, edge project use, edge env use

If required context is missing, the CLI prints an actionable error:

no workspace set — use --workspace/-w, run `edge link`, or `edge workspace use <slug>`

Global flags

These flags are available on every command:

Available commands

Authentication

Workspace management

Project management

Environments

Services

Deployments

Variables

Tokens

Context & utilities