# Projects

> List and delete your projects, and understand plan limits and name rules

Every deployable app is a **project**: a globally unique, account-owned name that carries your
deployed app. Projects are created or linked for you by [`voxal init`](/cli/init) and
[`voxal deploy`](/cli/deploy).

## voxal projects

```bash
voxal projects            # list your projects
voxal projects rm <name>  # delete a project
```

The command has an alias, `voxal project`. The `rm` subcommand also accepts `remove` and
`delete`.

### List

Listing shows your projects and your usage, such as `2/3 projects on the Free plan`. It is the
same view as [`voxal whoami`](/cli/auth).

### Remove

```bash
voxal projects rm old-app
```

Deletes the project and frees its name.

<Callout type="error" title="Permanent">
Deleting a project is permanent and frees its globally unique name for anyone to claim. Make
sure nothing depends on `ssh old-app@voxal.sh` first.
</Callout>

## Plans and limits

Your account carries a plan that caps how many projects you can own.

| Plan | Included apps |
| --- | --- |
| Free | 3 |
| Pro | 25 (then $1 / app / mo) |

At the limit, creating another project (via `init` or `deploy`) fails and tells you to delete
one or upgrade. Check your usage any time with [`voxal whoami`](/cli/auth).

## Name rules

Project names match `/^[a-z0-9][a-z0-9-]{0,62}$/`: lowercase letters, digits, and hyphens,
starting with a letter or digit, up to 63 characters. Names are normalized to trimmed
lowercase.

Some names are reserved and cannot be used, including `www`, `api`, `app`, `admin`, `ssh`,
`voxal`, `root`, `dashboard`, `login`, and `cli`.

---

Source: https://docs.voxal.sh/cli/projects