---
title: "lizard link"
description: "lizard link associates the current directory with an existing project, and optionally a specific service or workspace."
url: https://lizard.build/docs/cli/link/
updated: 2026-10-21
---

# lizard link

Associate the current directory with an existing project (and optionally a service). The link covers this exact folder, not its subfolders. A folder with no link uses your account's default project.

## Usage

```bash
lizard link [service] [flags]
```

## Flags

| Flag | Description |
|------|-------------|
| `-p, --project <id>` | Project name, slug, or ID |
| `-s, --service <name>` | Service to link |
| `-w, --workspace <ws>` | Workspace |

## Examples

### Link to an existing project

```bash
lizard link --project my-project
```

### Link to a project and a specific service

```bash
lizard link my-service --project my-project
```

### Link within a specific workspace

```bash
lizard link --project my-project --workspace my-workspace
```

## See also

- [lizard init](https://lizard.build/docs/cli/init.md) — create or select a project and link it in one step
- [lizard unlink](https://lizard.build/docs/cli/unlink.md) — remove the link from the current directory
- [lizard status](https://lizard.build/docs/cli/status.md) — show the linked workspace, project, and service
- [Architecture: Project](https://lizard.build/docs/concepts/architecture.md) — how the directory-to-project link works
