dots marketplace and dots plugin

The dots marketplace and dots plugin families, command by command. Every signature, argument, and option below is read from the CLI's own command tree, so this page cannot drift from dots --help. Every other family is listed in CLI Reference.

dots marketplace

dots marketplace [options] [command]

Browse, install, and publish marketplace listings, and manage the marketplace session.

Options:

• --marketplace-url <url> — Marketplace service base URL. Also read from MARKETPLACE_API_URL, then the stored login (dots marketplace login); defaults to the production marketplace.

dots marketplace login

dots marketplace login [options]

Log in to the marketplace via the browser device flow, then store the session token for later marketplace commands.

dots marketplace logout

dots marketplace logout [options]

Clear the stored marketplace session (leaves the API credential intact).

dots marketplace whoami

dots marketplace whoami [options]

Print the marketplace account the stored session authenticates as.

dots marketplace search

dots marketplace search [options] <query>

Search the marketplace catalog and print the matching listings.

Arguments:

• <query> — The search query (matched against titles, descriptions, tags, and seller).

Options:

• --type <type> — Filter to a listing type (e.g. superpower, dotabase_template, bundle).
• --subtype <subtype> — Filter to a Superpower subtype (e.g. skill, agent, prompt).
• --max-price <cents> — Approximate maximum price in CENTS; selects the catalog price band it falls in (free · <$10 · $10–50 · $50+).
• --free — Show only free listings (shorthand for the free price band).

dots marketplace info

dots marketplace info [options] <slug>

Print a listing's id and detail: type, current version, seller, price, publication status, and its trust summary.

Arguments:

• <slug> — The listing slug.

dots marketplace author

dots marketplace author [options] <handle>

Print a seller's PUBLIC author profile by handle: their identity, tier, verification, links, and every listing they have published. This is the third-person seller read — someone else's storefront page — where seller listings answers for the logged-in account only and search takes no author filter. Add --reviews for the roll-up of reviews across that seller's listings.

Arguments:

• <handle> — The seller's handle, as it appears on their profile and on their listings.

Options:

• --reviews — Also read the reviews of every listing this seller has published — the profile page's roll-up, each review carrying the listing it was left on, beside the average and total across them all. Off by default: it is a second request the profile itself does not need.

dots marketplace install

dots marketplace install [options] <slug>

Install a listing: resolve its current version via the service, then run the local install, streaming per-step progress.

Arguments:

• <slug> — The listing slug to install.

Options:

• --var <KEY=VALUE> — A KEY=VALUE install variable (repeatable) — supplies an adaptation-L1 variable the installer would otherwise prompt for.

dots marketplace update

dots marketplace update [options] [slug]

Update an installed listing (or every listing with an update available) to its current version, streaming per-step progress.

Arguments:

• [slug] — The installed listing slug to update. Omit and pass --all to update every eligible listing.

Options:

• --all — Update every installed listing that has an update available.

dots marketplace installed

dots marketplace installed [options]

List the listings installed into this workspace with their installed version, the latest published one, and whether an update is available.

Options:

• --limit <n> — Maximum records to return.
• --offset <n> — Records to skip before returning the page.
• --count — Print the number of records this list returns instead of the records themselves.

dots marketplace uninstall

dots marketplace uninstall [options] <slug>

Remove an installed listing's local registration. The rows, templates, and Spaces it created stay; what goes is the registration that binds them to the listing.

Arguments:

• <slug> — The installed listing slug to uninstall.

Options:

• --yes — Confirm the destructive action (required; it cannot be undone).
• --dry-run — Resolve and report what would change; writes nothing.

dots marketplace purchases

dots marketplace purchases [options]

Print the account's purchases and entitlements.

dots marketplace export

dots marketplace export [options] <slug>

Download an owned (or free) listing as a ZIP archive through the marketplace's in-app export. A listing that installs inside Dots is not exportable and says so.

Arguments:

• <slug> — The listing slug to export.

Options:

• --out <path> — Write the archive here instead of the server-named file in the working directory.

dots marketplace refund-request

dots marketplace refund-request [options] <purchase-id>

Request a refund on one of the account's purchases. Below the auto-refund limit it settles immediately and the entitlement is revoked; above it, it queues for an operator decision.

Arguments:

• <purchase-id> — The purchase id to request a refund on.

Options:

• --reason <text> — Why the refund is being requested (required above the auto-refund limit).
• --yes — Confirm the destructive action (required; it cannot be undone).
• --dry-run — Resolve and report what would change; writes nothing.

dots marketplace reviews

dots marketplace reviews [options] [command]

Read a listing's reviews and write, endorse, report, or answer one.

dots marketplace reviews list

dots marketplace reviews list [options] <slug>

Read one listing's reviews, newest first by default, with the full-set average, count, and per-star histogram beside the page.

Arguments:

• <slug> — The listing slug whose reviews to read.

Options:

• --limit <n> — Maximum records to return.
• --cursor <cursor> — Opaque pagination cursor from a prior page (meta.nextCursor).
• --count — Print the number of records this list returns instead of the records themselves.
• --sort <sort> — Order the page: newest, highest, lowest, or most_helpful.

dots marketplace reviews submit

dots marketplace reviews submit [options] <slug>

Write a review of a listing, or edit the review this account already left in place. Requires an entitlement and the review-window wait the service enforces.

Arguments:

• <slug> — The listing slug to review.

Options:

• --stars <n> — The rating, 1 to 5.
• --title <text> — A one-line review headline.
• --body <text> — The review body (markdown).
• --body-file <path> — Path to a file whose full UTF-8 content is used instead of --body (for text too large to pass inline). Mutually exclusive with --body.

dots marketplace reviews helpful

dots marketplace reviews helpful [options] <review-id>

Mark a review helpful. Idempotent per account — marking one twice counts once.

Arguments:

• <review-id> — The review id to mark helpful.

dots marketplace reviews report

dots marketplace reviews report [options] <review-id>

Report a review for moderation: it stamps the review as reported and opens an operator flag.

Arguments:

• <review-id> — The review id to report.

dots marketplace reviews respond

dots marketplace reviews respond [options] <review-id>

Answer a review as the listing's seller. One response per review — a second is refused rather than replacing the first.

Arguments:

• <review-id> — The review id to answer.

Options:

• --body <text> — The seller response body (markdown).
• --body-file <path> — Path to a file whose full UTF-8 content is used instead of --body (for text too large to pass inline). Mutually exclusive with --body.

dots marketplace seller

dots marketplace seller [options] [command]

The authenticated seller's own reads: listings, payouts, and analytics.

dots marketplace seller listings

dots marketplace seller listings [options]

List this seller's own listings in every status, drafts and in-review included — the seller-side view search cannot answer.

Options:

• --limit <n> — Maximum records to return.
• --offset <n> — Records to skip before returning the page.
• --count — Print the number of records this list returns instead of the records themselves.

dots marketplace seller payouts

dots marketplace seller payouts [options]

Read this seller's payout history, newest first, with the rolling eligible balance and whether payouts are connected.

Options:

• --limit <n> — Maximum records to return.
• --offset <n> — Records to skip before returning the page.
• --count — Print the number of records this list returns instead of the records themselves.

dots marketplace seller analytics

dots marketplace seller analytics [options]

Read this seller's aggregate analytics: installs, revenue, average rating, and refund rate, overall and per listing.

dots marketplace publish

dots marketplace publish [options] <path>

Publish a listing version from a local directory (manifest.json + payload.json), creating a listing unless --listing names an existing owned listing.

Arguments:

• <path> — Path to the listing directory (expects manifest.json + payload.json).

Options:

• --listing <listing-id> — Add the version to this existing owned listing id instead of creating a listing.
• --type <type> — Override/confirm the listing type; must match the manifest's listingType when both are present.
• --changelog <text> — Changelog note for this version.
• --changelog-file <path> — Path to a file whose full UTF-8 content is used instead of --changelog (for text too large to pass inline). Mutually exclusive with --changelog.
• --metadata-only — Repair the complete intent triad on --listing without creating or submitting a version.
• --capability <text> — What the listing does — the capability line of the intent-constraint triad.
• --use-when <text> — When to reach for it — the use-when line of the intent-constraint triad.
• --not-for <text> — What it is not for — the not-for line of the intent-constraint triad.
• --acknowledge-unresolved-variables — Declare any unresolved required variables intentional (the one documented escape from that hard blocker).

dots marketplace submit

dots marketplace submit [options] <listing-id>

Submit an existing owned listing for review without creating a new listing or version.

Arguments:

• <listing-id> — The owned listing id to submit.

Options:

• --acknowledge-unresolved-variables — Declare any unresolved required variables intentional (the one documented escape from that hard blocker).

dots marketplace abandon

dots marketplace abandon [options] <listing-id>

Archive an owned failed-publish draft while preserving its evidence and freeing its slug for a clean retry.

Arguments:

• <listing-id> — The owned draft listing id to abandon.

Options:

• --yes — Confirm the destructive action (required; it cannot be undone).
• --dry-run — Resolve and report what would change; writes nothing.

dots plugin

dots plugin [options] [command]

Author, run, build, and package a Dots plugin (the SDK Distribute axis).

dots plugin init

dots plugin init [options] <slot> [dir]

Scaffold a plugin directory: a dots-plugin.json manifest + a define* source stub for the slot kind.

Arguments:

• <slot> — The contributed slot — a define* helper name (e.g. defineTemplate, defineProperty, defineBehavior, defineView).
• [dir] — Target directory to scaffold into (defaults to the current directory).

Options:

• --name <name> — Plugin package name (npm-style, e.g. @acme/my-plugin). Defaults to the directory name.
• --force — Overwrite an existing dots-plugin.json / source stub in the target directory.

dots plugin dev

dots plugin dev [options] <pluginDir>

Run the plugin in a foreground local daemon, registering its contributed artifacts (Ctrl-C to stop).

Arguments:

• <pluginDir> — The plugin directory containing dots-plugin.json.

Options:

• --watch — Re-boot the daemon when a plugin source file changes.

dots plugin build

dots plugin build [options] <pluginDir>

Read the manifest, assemble the declarative payload, snapshot the entry-point sources, compute the SHA-256 over canonical JSON, and write the built artifact.

Arguments:

• <pluginDir> — The plugin directory containing dots-plugin.json.

Options:

• --out <dir> — Output directory for the built artifact (defaults to <pluginDir>/dist).

dots plugin package

dots plugin package [options] <dir>

Build the marketplace manifest from a built artifact and emit the listing record locally (no hosted backend). A declarative plugin packages as dotabase_template; a code-bearing plugin (defineBehavior) as sdk_plugin.

Arguments:

• <dir> — The plugin directory (or a previously-built artifact directory).

Options:

• --out <path> — Output path for the listing record (defaults to <dir>/dist/listing.json).

dots plugin install

dots plugin install [options] <dir>

Install a plugin from a local directory into the configured daemon/API (parses the manifest, snapshots the entry sources, computes the checksum, and posts to /plugins/install).

Arguments:

• <dir> — The plugin directory containing dots-plugin.json and its entry-point sources.

dots plugin enable

dots plugin enable [options] <name>

Enable an installed plugin (registers its contributed behavior slots).

Arguments:

• <name> — The plugin package name (e.g. @acme/my-plugin).

dots plugin disable

dots plugin disable [options] <name>

Disable an installed plugin (unregisters its slots; the install snapshot is retained).

Arguments:

• <name> — The plugin package name (e.g. @acme/my-plugin).

dots plugin upgrade

dots plugin upgrade [options] <dir>

Upgrade an installed plugin in place from a local directory (same assembly as install; the manifest name must already be installed, and its onUpgrade hook runs through the sandbox).

Arguments:

• <dir> — The plugin directory containing dots-plugin.json and its entry-point sources.

dots plugin uninstall

dots plugin uninstall [options] <name>

Uninstall a plugin (runs its onUninstall hook through the sandbox and removes the install row).

Arguments:

• <name> — The plugin package name (e.g. @acme/my-plugin).

Options:

• --yes — Confirm the destructive action (required; it cannot be undone).
• --dry-run — Resolve and report what would change; writes nothing.

dots plugin list

dots plugin list [options]

List the active company's installed plugins (newest first).

Options:

• --limit <n> — Maximum records to return.
• --offset <n> — Records to skip before returning the page.
• --count — Print the number of records this list returns instead of the records themselves.

generator: apps/docs/pipeline/generate-reference.ts — regenerate with pnpm --filter @dots/docs docs:generate:reference; a hand edit to this page fails the docs drift gate.