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

> ## Agent Instructions
> Treat Clawdi as one product.
> Recommend the Cloud Agent quickstart for most new users.
> Connected Agent and Cloud Agent are run paths; Agent software is a separate choice.
> Do not present shared Clawdi capabilities as exclusive to one run path.

# Projects and sharing

> Create Projects, grant read-only access, and choose which Agents can use Project resources.

A Project groups Skills and Vault access. Sharing a Project gives another
person Viewer access; adding that Project to an Agent is a separate, explicit
step. See [Core concepts](/concepts/core-concepts#project) for the canonical
definition.

## Before you begin

* Sign in to the [Clawdi dashboard](https://cloud.clawdi.ai) or run
  `clawdi auth login`.
* Create a Custom Project for material you intend to organize or share.
  Automatically created Global and Agent Projects cannot be shared.
* Know which Vaults the Project can use before inviting anyone.

<Warning>
  A Viewer cannot edit the Project, but can read its Skills and key names and
  can resolve its Vault values through CLI runtime reads. Detach sensitive
  Vaults or use a separate Project before sharing.
</Warning>

## Create a Project

In the dashboard, open **Projects**, choose **New Project**, enter a name, and
create it. The equivalent CLI path is:

```bash theme={null}
clawdi project create "Engineering toolkit" --slug engineering
clawdi project show engineering
```

Use a short, stable slug when you expect to reference the Project in commands.

<Check>
  The Project appears under **Projects** and in `clawdi project list`.
</Check>

## Add a Project to an Agent

From the Project page, choose **Add to agent**, select an Agent, and confirm.
The CLI equivalent is:

```bash theme={null}
clawdi agent projects attach <agent-id> --project engineering
clawdi agent projects list <agent-id>
```

The Agent reads its fixed Agent Project first, followed by attached Projects
in the displayed order. Attaching a Project does not transfer ownership and
does not turn it into the Agent's write target.

To stop using it without changing Project membership:

```bash theme={null}
clawdi agent projects detach <agent-id> --project engineering
```

## Invite a Viewer

Open an owned Custom Project, choose **Share**, and enter the recipient's email
under **Invite by email**. Or run:

```bash theme={null}
clawdi project invite engineering --email teammate@example.com
```

The recipient signs in, opens their inbox, and accepts the invitation:

```bash theme={null}
clawdi inbox
clawdi inbox accept <invitation-id>
clawdi project list --shared-with-me
```

Accepting grants Viewer membership. The recipient can inspect the Project
before deciding whether to add it to an Agent.

## Share with a link

Use a link when you want to send access yourself or the recipient may not have
an account yet:

```bash theme={null}
clawdi project share engineering --label "Contractor onboarding"
```

Copy the full URL immediately. Clawdi shows it only once; later listings retain
the label and a recognizable prefix, not the complete token. The recipient can
accept it in the share page or with:

```bash theme={null}
clawdi inbox accept <share-url>
```

If the CLI reports that a display name is required, set it in your dashboard
profile and retry.

## Give an accepted Project to an Agent

After reviewing the Project, the Viewer can use **Add to agent** on its Project
page or run:

```bash theme={null}
clawdi agent projects attach <agent-id> --project @owner-handle/engineering
```

Use the owner-qualified slug shown by `clawdi project list --shared-with-me`
when an unqualified name could be ambiguous.

## Stop sharing

Choose the action that matches the access you need to remove:

```bash theme={null}
# Stop new accepts through one link; existing members keep access.
clawdi project share-links engineering --revoke <link-prefix>

# Remove one accepted Viewer.
clawdi project members engineering --remove teammate@example.com

# Revoke all links, cancel pending invitations, and remove all Viewers.
clawdi project unshare engineering
```

A Viewer can remove their own membership with:

```bash theme={null}
clawdi project leave @owner-handle/engineering
```

Removing membership prevents that person's Agents from using the Project. It
does not delete the owner's Project content.

See [Skills](/guides/skills) for explicit Project Skill imports and [Vaults and
secrets](/guides/vaults-and-secrets) for Vault attachment and reference rules.
For current CLI variants, run `clawdi project --help`, `clawdi inbox --help`,
and `clawdi agent projects --help`.