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

# Platform Bundles

> Bundle management in CloudShip Platform

## Bundle Registry

CloudShip Platform hosts a bundle registry for sharing agent configurations across your organization.

## Uploading Bundles

### Via CLI

```bash theme={null}
# Upload from environment
stn bundle share production

# Upload existing bundle file
stn bundle share ./my-bundle.tar.gz
```

### Via Dashboard

1. Go to **Bundles** in CloudShip dashboard
2. Click **Upload Bundle**
3. Drag and drop your `.tar.gz` file
4. Add metadata (name, description, tags)
5. Click **Publish**

## Installing from CloudShip

```bash theme={null}
# Install by UUID
stn bundle install e26b414a-f076-4135-927f-810bc1dc892a my-environment

# Install with stn up
stn up --bundle e26b414a-f076-4135-927f-810bc1dc892a
```

## Bundle Visibility

| Visibility       | Access                 |
| ---------------- | ---------------------- |
| **Private**      | Only your organization |
| **Organization** | All org members        |
| **Public**       | Anyone (with link)     |

## Cherry-Pick Manifests

Select specific agents from multiple bundles:

```json theme={null}
{
  "sources": [
    {
      "bundle_id": "e26b414a-f076-4135-927f-810bc1dc892a",
      "agents": ["security-scanner", "code-reviewer"]
    },
    {
      "bundle_id": "f37c525b-g187-5246-a38g-921cd2ed933b",
      "agents": ["devops-helper"]
    }
  ]
}
```

Create custom bundle from manifest:

```bash theme={null}
curl -X POST https://app.cloudshipai.com/api/registry/custom-bundle/ \
  -H "Authorization: Bearer $CLOUDSHIP_TOKEN" \
  -d @manifest.json \
  --output custom-bundle.tar.gz
```

## Version Management

### Semantic Versioning

Bundles support semantic versioning:

```json theme={null}
{
  "name": "security-bundle",
  "version": "1.2.3"
}
```

### Installing Specific Versions

```bash theme={null}
stn bundle install security-bundle@1.2.3 my-env
```

### Latest vs Pinned

* **Latest**: Always get newest version
* **Pinned**: Lock to specific version for reproducibility

## Organization Bundles

### Sharing Within Org

When you upload a bundle, choose organization visibility:

```bash theme={null}
stn bundle share ./bundle.tar.gz --visibility organization
```

### Team Permissions

| Role   | Can Upload | Can Install | Can Delete |
| ------ | ---------- | ----------- | ---------- |
| Admin  | ✓          | ✓           | ✓          |
| Member | ✓          | ✓           | Own only   |
| Viewer | ✗          | ✓           | ✗          |

## Bundle Analytics

CloudShip tracks:

* Download counts
* Active installations
* Error rates
* Popular agents

View analytics in dashboard under **Bundles → Analytics**.