SUBSCRIPTION COMMANDS

The swamp subscription command group shows the plan and billing standing of the signed-in user and their collectives, and opens the swamp-club billing page.

Running swamp subscription with no subcommand prints group help. Both subcommands need a swamp-club.com account, like any other command — see Swamp Account Requirement — and both run outside a Swamp repository.

swamp subscription status

Show the plan and billing standing of the signed-in user and each collective they belong to.

swamp subscription status

status makes one call to swamp-club, the same one swamp auth whoami makes, and words each collective exactly as swamp auth whoami does.

Example output:

alice (alice@example.com) on https://swamp-club.com
Plan: Team
Collectives:
  alice  trial: 25 days left (ends 2026-11-20)
  acme   Team  active

To manage billing:  swamp subscription start

Standings

Each collective is listed by slug, followed by its standing:

A collective on any plan other than free shows its plan and is never shown as on a free trial. A free collective shows the first that applies: a running trial, then covered, then trial ended.

Plan line

Plan: names the strongest plan across the user's collectives, as swamp-club chooses it: Admin, then the highest paid plan, then Personal License. The line is omitted when the strongest plan is free.

Call to action

The last line points at swamp subscription start:

Collective tokens

With a collective token in SWAMP_API_KEY or SWAMP_API_KEY_FILE, the first line names the collective instead of a user, and only that collective is listed. A collective token is not an owner or admin, so no billing status is shown:

Collective token: acme on https://swamp-club.com
Plan: Team
Collectives:
  acme  Team

To manage billing:  swamp subscription start

Servers that report no standing

When the server sends no subscription standing, status prints the identity line followed by:

This Swamp Club server does not report subscriptions.

No Plan: line, collectives or call to action follow, and the exit code is 0. This is usually an older or self-hosted swamp-club. It is also printed for a collective token whose standing the server could not read.

SWAMP_CLUB_URL

When SWAMP_CLUB_URL is set, status asks that server instead of the one stored at login.

JSON output

swamp subscription status --json

{
  "serverUrl": "https://swamp-club.com",
  "username": "alice",
  "plan": "team",
  "planName": "Team",
  "entitlementsReported": true,
  "collectives": [
    {
      "slug": "alice",
      "plan": "free",
      "planName": "Free",
      "subscriptionStatus": null,
      "trial": {
        "state": "active",
        "startedAt": "2026-10-21T15:47:22.164Z",
        "endsAt": "2026-11-20T15:47:22.164Z",
        "trigger": "signed_up",
        "dayNumber": 6,
        "daysRemaining": 25,
        "totalDays": 30,
        "extended": false
      },
      "privateExtensions": "allowed"
    },
    {
      "slug": "acme",
      "plan": "team",
      "planName": "Team",
      "subscriptionStatus": "active",
      "trial": null,
      "privateExtensions": "allowed"
    }
  ],
  "billingUrl": "https://swamp-club.com/billing"
}

Each entry in collectives has:

The user's email appears on the identity line but never in the JSON document.

swamp subscription start

Open the swamp-club billing page in a browser, to upgrade or manage billing for yourself or a collective.

swamp subscription start

start makes no call to swamp-club of its own. It opens:

• <server>/billing by default
• <server>/o/<slug>/billing with --collective

The server is SWAMP_CLUB_URL when set, else the server stored at login, else https://swamp-club.com.

The slug is not checked on the command line; the billing page decides what the user may manage. A personal collective's page redirects to /billing. Only owners and admins can manage a collective's billing; a member is sent to the collective's page at /o/<slug>. A user signed out in the browser is asked to sign in, then returned to the billing page.

Plans are bought, changed and cancelled on the billing page, and a Personal License is taken there too; the CLI only opens it.

Output:

No browser can be opened over SSH or on a headless machine, for example:

Could not open a browser. Open this URL to manage billing:
  https://swamp-club.com/billing

All three exit 0.

JSON output

swamp subscription start --collective acme --no-browser --json

{
  "url": "https://swamp-club.com/o/acme/billing",
  "opened": false,
  "collective": "acme"
}