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

# Publish to Marketplace

> Package, sign, submit, and list your AOS connector on the ArgentOS Marketplace.

## Prerequisites

* Connector built and tested (see [Build a Connector](/connectors/build))
* All certification gates passed
* Ed25519 keypair for package signing
* Marketplace author account

## Package Format

Marketplace packages are `.argent-pkg` files (gzipped tarballs):

```
aos-{name}.argent-pkg (tar.gz)
├── argent.plugin.json          <- Package manifest
├── connector.json              <- Connector metadata
├── agent-harness/              <- Python CLI harness
├── README.md                   <- Documentation
├── SIGNATURE                   <- Ed25519 signature
└── SHA256SUMS                  <- Checksums
```

## Step 1: Create Package Manifest

Create `argent.plugin.json` in your connector directory:

```json theme={null}
{
  "name": "aos-{name}",
  "version": "1.0.0",
  "description": "AOS connector for {Vendor} — {what it does}",
  "author": {
    "name": "Your Name",
    "publicKey": "<Ed25519 public key base64>"
  },
  "category": "connectors",
  "tags": ["vendor-name", "category-tag"],
  "license": "MIT",
  "pricing": "free",
  "price_cents": 0,
  "compatibility": {
    "argentos": ">=2026.3.0"
  },
  "permissions": ["network"]
}
```

### Pricing Options

| Type         | Duration                      | Use Case                         |
| ------------ | ----------------------------- | -------------------------------- |
| `free`       | Unlimited                     | Open source, no license required |
| `trial`      | 7-30 days                     | Time-limited evaluation          |
| `pro`        | 1 year, 3 activations         | Standard paid license            |
| `enterprise` | 1 year, unlimited activations | Multi-instance deployment        |
| `per-skill`  | Perpetual, 1 activation       | One-time purchase                |

Revenue split for paid connectors: **70% creator / 30% ArgentOS**. Payouts via Stripe Connect.

## Step 2: Build the Tarball

```bash theme={null}
cd tools/aos/aos-{name}

tar -czf aos-{name}.argent-pkg \
  argent.plugin.json \
  connector.json \
  agent-harness/ \
  README.md
```

## Step 3: Generate Checksums

```bash theme={null}
sha256sum aos-{name}.argent-pkg > SHA256SUMS
```

## Step 4: Sign the Package

Sign with your Ed25519 private key:

```bash theme={null}
# Sign the SHA256 hash
# Add SIGNATURE and SHA256SUMS to the package:
tar -czf aos-{name}.argent-pkg \
  argent.plugin.json \
  connector.json \
  agent-harness/ \
  README.md \
  SHA256SUMS \
  SIGNATURE
```

## Step 5: Submit to Marketplace

```bash theme={null}
curl -X POST https://marketplace.argentos.ai/api/v1/publish \
  -H "Authorization: Bearer <your-author-token>" \
  -F "package=@aos-{name}.argent-pkg" \
  -F "manifest=$(cat argent.plugin.json)"
```

The marketplace server:

1. Validates the manifest schema
2. Verifies the Ed25519 signature against your registered public key
3. Runs static analysis for malicious patterns
4. Audits declared permissions
5. Stores the package in the database + CDN
6. Returns status: `published`, `pending_review`, or `flagged`

## Step 6: Verify Your Listing

```bash theme={null}
# Search the catalog
curl https://marketplace.argentos.ai/api/v1/catalog?q=aos-{name}

# Or via CLI
argent marketplace search {name}
```

Your connector should appear in the dashboard under **Settings > Marketplace**.

## Installing from Marketplace

Users install your connector with:

```bash theme={null}
argent marketplace install aos-{name}
```

This downloads the package to `~/.argentos/connectors/aos-{name}/`, verifies the signature and checksums, and makes it available to the agent on the next gateway restart.

## Marketplace API Reference

| Method | Path                           | Purpose                                 |
| ------ | ------------------------------ | --------------------------------------- |
| `GET`  | `/api/v1/catalog`              | Search packages (query, category, tags) |
| `GET`  | `/api/v1/catalog/:id`          | Package details                         |
| `GET`  | `/api/v1/catalog/:id/download` | Signed download URL                     |
| `POST` | `/api/v1/publish`              | Upload new package/version              |
| `POST` | `/api/v1/activate`             | Activate a license key                  |
| `GET`  | `/api/v1/license/:key`         | Check license status                    |

## Version Updates

To publish an update:

1. Bump the `version` in both `argent.plugin.json` and `connector.json`
2. Rebuild the tarball
3. Re-sign with your key
4. Submit via the same `/api/v1/publish` endpoint

The marketplace handles versioning — users see the update in their dashboard and can upgrade with `argent marketplace install aos-{name}`.

## Public Core Marketplace

Public Core (free) installations see the marketplace without a license gate. The catalog shows all `free` packages by default. Paid packages display pricing but require license activation to download.