Skip to main content
Projects are workspaces that group servers, API keys, and billing.

​
ezforge project create

Create a new project. 
ezforge project create <name>
Example: 
ezforge project create my-weather-app
Output: 
✓ Created project: my-weather-app (proj_abc123)

​
ezforge project list

List all your projects. 
ezforge project list
Output: 
ID           NAME              SERVERS  CREATED
proj_abc123  my-weather-app    3        2026-01-15
proj_def456  analytics-tools   1        2026-02-01

​
ezforge project use

Set the default project for subsequent commands. 
ezforge project use <name-or-id>
This saves the project to ~/.config/ezforge/config.json and to ezforge.toml in the current directory (if present).

​
ezforge project delete

Permanently delete a project and everything it contains. 
ezforge project delete <name-or-id> [--force]
The --force flag skips the confirmation prompt.
Deleting a project is irreversible. All servers, deployments, API keys, and billing history are permanently removed.

​
ezforge project create-key

Create an API key for the project. 
ezforge project create-key <project> --name <label> --scopes <scope1,scope2>
Example: 
ezforge project create-key my-weather-app --name "ci-deploy" --scopes "deployments:write,servers:read"
Output: 
✓ API key created

  Name:    ci-deploy
  Key:     ezf_live_xxxxxxxxxxxxxxxxxxxx
  Scopes:  deployments:write, servers:read

  Save this key — it will not be shown again.