# Projects & setup (/docs/cli/projects)



## Guided setup [#guided-setup]

For first-time use, the easiest path is:

```bash
cd your-app
layers setup
```

This walks through authentication, detecting your framework and
platforms, connecting social / ad accounts, and initializing the
project.

`layers get-users` is an alias for `layers setup`.

## Initialize a directory [#initialize-a-directory]

If you already have a Layers project and just want to bind this
directory to it:

```bash
layers init
# interactive: pick org and project, writes .layers/config.json
```

Or non-interactively:

```bash
layers init --org <org-id> --project <project-id>
```

The resulting `.layers/config.json` records the org and project IDs so
later commands in this directory use them by default.

## Link to an existing project [#link-to-an-existing-project]

```bash
layers link
layers link <project-id>
```

Similar to `init` but runs from a working directory without requiring a
wizard.

## List organizations and projects [#list-organizations-and-projects]

```bash
layers orgs list
layers projects list
layers projects list --org <org-id>
```

## Switch defaults [#switch-defaults]

```bash
layers orgs switch
layers projects switch
layers projects switch <project-id>
```

Sets the CLI's default org / project. Stored in the global config
(`~/.config/layers/config.json`).

## Show current user / context [#show-current-user--context]

```bash
layers whoami
```

## Open the dashboard [#open-the-dashboard]

```bash
layers open
```

Opens the web dashboard in your browser for the current project.