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

# link

> Link your local directory to an Openlayer project

The `openlayer link` command links your local directory to an [Openlayer project](/workspace-and-projects/creating-and-loading-projects).

<Info>
  If you are setting up a directory for the first time, use
  [`openlayer init`](/api-reference/cli/commands/init) instead. It signs you in, creates or links
  the project, and scaffolds your `openlayer.json` in one guided flow, so no separate `link`
  step is needed.

  Reach for `link` when your configuration already exists and you only need the link — for
  example to connect an existing `openlayer.json` to a project, or to re-point a directory at a
  different project. When creating a new project, `link` reads the task type from the
  `openlayer.json` already in the directory rather than asking for it.
</Info>

## Usage

```bash theme={null}
openlayer link
```

When no arguments are provided, an interactive prompt will be displayed asking the user
to confirm that they want to set up a link between the local directory and an Openlayer project,
if they want to link to an existing project or create a new one, and for the project name.

The `--project` name can also be provided as a flag:

```bash theme={null}
openlayer link --project=[project name]
```