# Manage projects (/guides/projects)



This page shows how to work with projects. For what projects are and how they
relate to organizations and services, read
[Accounts, organizations, and projects](/guides/account-model).

Every service lives in one project, and the CLI always acts on your active
project.

## Create a project [#create-a-project]

```bash
acc projects create --name my-app
acc projects list
```

In the web app, open **Projects** and create one from there. The new project
belongs to the organization you currently have selected.

## See and switch the active project [#see-and-switch-the-active-project]

```bash
acc whoami               # shows who you are and the active project
acc projects switch      # pick from a list
acc projects switch <id> # or name the project directly
```

To act on another project for one command, pass it explicitly:

```bash
acc services list -p <project-id-or-name>
acc deployments --project <project-id-or-name>
```

## Point CI or an agent at a project [#point-ci-or-an-agent-at-a-project]

Set two environment variables. Every command then runs against that project
without prompts; add `-y` to commands that ask for confirmation.

```bash
export AF_TOKEN="..."        # a personal access token, see Create and use access tokens
export AF_PROJECT_ID="..."   # from acc projects list
acc whoami --json
acc services deploy -y
```

Use one project per environment (for example `my-app-staging` and
`my-app-production`) and give each pipeline its own `AF_PROJECT_ID`.

## Rename a project [#rename-a-project]

```bash
acc projects update <id>
```

## Invite people [#invite-people]

People are invited at the organization level, and access to projects is set
per person. In the web app, open **Members** (owners and admins only) and send
an invitation. Choose a role, and for a member, choose whether they can see all
projects or only selected ones. Inviting requires an active paid subscription.

Roles are explained in [Accounts, organizations, and projects](/guides/account-model#roles).

## Delete a project [#delete-a-project]

Deleting a project deletes every service in it and closes their deployments.

```bash
acc projects delete <id>
```

Before deleting, run `acc services list -p <id>` and make sure nothing there
is still needed.

## Next steps [#next-steps]

* [Accounts, organizations, and projects](/guides/account-model)
* [Create and use access tokens](/guides/api-keys)
* [Manage billing and credits](/guides/billing)