> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ezforge project

> Create and manage projects

Projects are workspaces that group servers, API keys, and billing.

## ezforge project create

Create a new project.

```bash theme={null}
ezforge project create <name>
```

**Example:**

```bash theme={null}
ezforge project create my-weather-app
```

Output:

```
✓ Created project: my-weather-app (proj_abc123)
```

***

## ezforge project list

List all your projects.

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
ezforge project delete <name-or-id> [--force]
```

The `--force` flag skips the confirmation prompt.

<Warning>
  Deleting a project is irreversible. All servers, deployments, API keys, and billing history are permanently removed.
</Warning>

***

## ezforge project create-key

Create an API key for the project.

```bash theme={null}
ezforge project create-key <project> --name <label> --scopes <scope1,scope2>
```

**Example:**

```bash theme={null}
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.
```