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

# Managing Projects

> Bind projects to your license, view per-project stats, and manage active projects from the dashboard.

# Managing Projects

The Projects page lists every project bound to your auto-sop license with per-project stats and status indicators.

## Binding a project

To connect a project to your dashboard, run the install command with your license key:

```bash theme={null}
cd ~/projects/my-app
auto-sop install --license YOUR_LICENSE_KEY
```

The project appears in your dashboard within seconds. Each project is identified by its **project slug** — typically the directory name.

<Tip>
  Find your license key at the top of the dashboard Overview page, or in **Settings > License Key**.
</Tip>

## Project list

The Projects page displays a card grid with each bound project showing:

| Field               | Description                                   |
| ------------------- | --------------------------------------------- |
| **Project slug**    | Directory name used as the project identifier |
| **Directive count** | Number of active directives for this project  |
| **Fire count**      | Total confirmed directive fires               |
| **Status**          | Whether the project is actively syncing       |

## Free vs Pro limits

<CardGroup cols={2}>
  <Card title="Free Plan" icon="gift">
    **1 active project** — You can bind one project at a time. To switch, uninstall from the current project and install in a new one.
  </Card>

  <Card title="Pro Plan" icon="rocket">
    **Unlimited projects** — Bind as many projects as you want. All sync independently with their own stats and directives.
  </Card>
</CardGroup>

## Per-project metrics

Each project card shows detailed metrics synced from the CLI:

* **Confirmed fires total** — how many times directives in this project have been triggered
* **Directive IDs** — list of active directive identifiers
* **Sync status** — when the project last synced metrics to the cloud

## Empty state

If you haven't bound any projects yet, the Projects page shows a friendly empty state with a link back to the Quick Start guide on the Overview page.

<Info>
  Projects are linked by license key. If you regenerate your license key in Settings, you'll need to re-run `auto-sop install --license NEW_KEY` in each project.
</Info>

## Removing a project

To unbind a project from your dashboard:

```bash theme={null}
cd ~/projects/my-app
auto-sop uninstall
```

This removes hooks and the managed CLAUDE.md section. The project disappears from the dashboard on the next sync cycle.