---
source: CrewKit documentation
url: https://crewkit.io/docs/sharing.md
title: "Session sharing"
description: "Share any conversation with a link — org-scoped or public, with expiry and inline annotations."
---


Any session can be shared with a link. Choose who can open it, how much it exposes, and when it expires. Viewers can annotate the shared conversation inline, so a session becomes something your team can discuss — not just replay.

---

## Create a share link

### From the terminal interface

In crewkit's interactive terminal interface (`crewkit tui`), press `F12` then `s` during a session. Pick a share level (Summary, Transcript, or Full) and an expiry (24 hours, 7 days, 30 days, or never). The link is created and copied to your clipboard.

### From the CLI

```bash
crewkit sessions share <session-id>                      # Org-visible transcript link, expires in 7 days
crewkit sessions share <session-id> --level summary      # Share the summary only
crewkit sessions share <session-id> --expires 30         # Expire in 30 days
crewkit sessions share <session-id> --list               # List existing shares for the session
crewkit sessions share <session-id> --revoke <share-id>  # Revoke a share
```

Session IDs come from `crewkit sessions list` — short prefixes are accepted.

**Flags:**

| Flag | Description |
|------|-------------|
| `--access <org\|public>` | Who can open the link: `org` members (default) or anyone (`public` requires an org admin) |
| `--level <summary\|transcript\|full>` | How much the link exposes (default: `transcript`) |
| `--expires <days>` | Days until the link expires (default: 7; `0` = never) |
| `--list` | List existing shares for this session |
| `--revoke <share-id>` | Revoke a share by ID (short IDs accepted) |
| `--json` | Output JSON for piping |

### From the dashboard

Open a conversation and use the share dialog. It offers the same choices: visibility (Organization or Public), share level, and expiry.

---

## Share levels

| Level | What viewers see |
|-------|------------------|
| `summary` | Title, AI summary, tags, quality scores, and timestamps — no cost, model, or transcript |
| `transcript` | Everything in summary, plus cost, model, turn count, and the full turn-by-turn transcript |
| `full` | Everything in transcript, plus token breakdown, metrics, and git context |

Sessions captured in minimal telemetry mode only ever expose the summary level, regardless of what the link allows.

---

## Visibility

- **Organization** — viewers must be signed in as members of your organization.
- **Public** — anyone with the link can open it. Creating public links requires an org admin.

Revoked and expired links stop working immediately.

---

## Annotations

Anyone who can open a shared conversation can read its annotation thread. Signed-in members of the organization can add comments inline; annotation authors and org admins can delete them. Annotations live with the share, so feedback stays attached to the exact session it's about.

---

## Manage your shares

The **Shares** page in the dashboard (`/kit/shares`) lists everything in one place:

- **My shares** — links you created, with revoke controls
- **Shared with me** — org-visible links others created
- **All (org)** — every share in the organization (admins only)

---

## Next steps

- [Team management](/docs/team)
- [Analytics](/docs/analytics)
- [Artifacts and project memory](/docs/artifacts)