Billing

The billing commands let you browse the public plan catalog and inspect your own subscription, usage, and referral credits from the terminal. There are two command groups on this page:

billing:* — the public plan catalog: subscription plans, per-plan feature matrices, and add-on SKUs. These endpoints are public and work without authentication.
settings:* (billing-related) — your own subscription status, usage breakdown, and referral code. These require a valid API key (see API Keys).

Every command accepts the global flags --json (default), --table, --verbose, --api-key <key>, and --api-url <url>. You can also set SOME_API_KEY / SOME_API_URL in the environment. None of the billing commands define their own flags.

settings:billing

Get subscription status and plan info — your current plan, subscription status, and renewal details.

so-me settings:billing

Examples

# Full subscription info
so-me settings:billing

# Just plan name + status
so-me settings:billing | jq '{plan: .plan.name, status: .plan.subscriptionStatus}'

# Compact table
so-me settings:billing --table

settings:usage

Get the usage breakdown for the current billing period (posts, bio links, social accounts, media storage, team members, and AI text/image/video credits).

so-me settings:usage

Examples

# JSON
so-me settings:usage

# Posts used vs limit
so-me settings:usage | jq '.tenant.posts'

# AI text/image/video credit usage
so-me settings:usage | jq '{text: .tenant.aiText, image: .tenant.aiImage, video: .tenant.aiVideo}'

# Table
so-me settings:usage --table

settings:referral-code

Get your referral code and totals (total referrals, credits earned).

so-me settings:referral-code

Examples

# Full object
so-me settings:referral-code

# Just the code
so-me settings:referral-code | jq -r '.code'

# Share link (combine with your public site)
echo "https://so-me.studio/signup?ref=$(so-me settings:referral-code | jq -r '.code')"

billing:plans

List all available subscription plans. Only visible, non–add-on plans are returned, ordered by their display sort order. Each plan carries both monthly and yearly pricing (monthlyPrice, yearlyPrice), the corresponding Lemon Squeezy variant IDs (monthlyVariantId, yearlyVariantId), display name, and description.

so-me billing:plans

Examples

# All plans as JSON
so-me billing:plans

# Compact table
so-me billing:plans --table

# Name + monthly/yearly price list
so-me billing:plans | jq -r '.[] | "\(.name)\t$\(.monthlyPrice)/mo\t$\(.yearlyPrice)/yr"'

# Just the monthly Lemon Squeezy variant IDs
so-me billing:plans | jq -r '.[] | "\(.name): \(.monthlyVariantId)"'

billing:plan-features

Get the feature list (post limits, seat count, storage, AI credits, etc.) for a specific plan. Active features are returned first, followed by coming_soon features; inactive features are omitted.

so-me billing:plan-features <name>

string

required

Internal plan identifier: hobby (Free), solo (Lite), team (Standard), scale (Advanced), or lifetime (Lifetime).

Examples

# Features for Free
so-me billing:plan-features hobby

# Features for Advanced
so-me billing:plan-features scale

# Compare posts-per-month across plans
for p in hobby solo team scale; do
  echo -n "$p: "
  so-me billing:plan-features $p | jq -r '.[] | select(.name == "Posts/month") | .numericValue'
done

# As a table
so-me billing:plan-features team --table

Plan identifiers are matched exactly (case-sensitive). An unknown identifier returns an empty list rather than an error. Use hobby for Free, solo for Lite, team for Standard, scale for Advanced, or lifetime for Lifetime.

billing:addons

List available add-on plans. Add-ons are the plans that carry an addonType — MEMBER (extra team seats), TENANT (extra workspaces), or AI_CREDIT (AI credit packs).

so-me billing:addons

Examples

# All add-ons
so-me billing:addons

# Add-on table
so-me billing:addons --table

# Extra-workspace add-ons only
so-me billing:addons | jq '.[] | select(.addonType == "TENANT")'

# AI credit packs only
so-me billing:addons | jq '.[] | select(.addonType == "AI_CREDIT")'

Getting Started

Publishing

AI Studio

Inbox & Engagement

Analytics

Biolink

Team & Collaboration

Settings & Billing

Webhooks

Support

settings:billing

settings:usage

settings:referral-code

billing:plans

billing:plan-features

billing:addons

​settings:billing

​settings:usage

​settings:referral-code

​billing:plans

​billing:plan-features

​billing:addons

settings:billing

settings:usage

settings:referral-code

billing:plans

billing:plan-features

billing:addons