Projects

A project groups related services together inside a workspace. Each project can have multiple environments (e.g. production, staging, dev).

The project command can be shortened to proj:

edge proj list

All project commands require a workspace. Set one with edge workspace use or pass --workspace/-w.

list

List all projects in the active workspace. The active project is marked with *.

edge project list
edge project list --workspace acme-corp --json

Example output

    SLUG        NAME
*   payments    Payments Service
    auth        Auth Service
    infra       Infrastructure

create

Create a new project in the active workspace.

edge project create <name>

edge project create "Payments Service"

use

Set the active project. Saved to ~/.simplifyd/config.json.

edge project use <slug|name>

You can pass either the slug or the human-readable name. Names with spaces must be quoted:

edge project use payments
edge project use "Payments Service"

After the project is set, the CLI also resolves the active environment:

• Interactive terminal — you are prompted to pick an environment from a numbered list.
• Non-interactive / CI — pass --env to set both in one command:

edge project use payments --env production

If --env is omitted in a non-interactive environment, the active environment is cleared and a warning is shown.

On success the CLI prints the name and slug for each value set:

✓ Active project set to Payments Service (payments)
✓ Active environment set to Production (production)

Commands that require a project will use the active project automatically. Override per-command with --project/-p.