dots search and dots tags

The dots search and dots tags 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.

The survey read on this page — search — answers at summary by default: identity plus the bounded fields, under a footer naming the tier. --level scan narrows a survey read to the identity fields for that record family. Row reads keep the human id, title, and icon. --level full restores the widest record, and a row's body renders at full alone; --fields bypasses the ladder for an exact allowlist. A read that names one record answers at full already, so the pattern is scan-then-select: survey the collection cheaply, then pull the one record you chose in full.

dots search

dots search [options] <query>

Cross-Dotabase Universal Search over everything you can read (smart hybrid: keyword + semantic).

Arguments:

• <query> — Search query text.

Options:

• --diiice <value> — Filter to a DIIICE category (data | intelligence | instructions | ideas | context | examples; repeatable, OR together).
• --dotabase <ref> — Narrow to one Dotabase (UUID, slug, or canonical human id).
• --playbook <ref> — Narrow to a Power-Up Playbook's curated member rows (a PLAYBOOK-N human id or its row UUID). Combines with --dotabase (both narrow).
• --scope <value> — Search entity scope: all or a registered entity-type key.
• --domain <label> — Filter to a domain label (repeatable, OR together).
• --tags, --tag <label> — Filter to a tag label (repeatable, OR together).
• --source <value> — Filter to a connector source-platform slug — the originating import adapter (repeatable, OR together).
• --recency <bucket> — Filter by recency bucket: last_day | last_week | last_month | last_90_days | older.
• --lifecycle <state> — Lifecycle filter: active | archived | all.
• --verified <state> — Verification filter: verified | unverified | all.
• --sort <token> — Sort order: relevance (default) | updated | created.
• --limit <n> — Maximum results to return (1-50, default 20).
• --cursor <cursor> — Opaque keyset pagination cursor from a prior page (meta.nextCursor).
• --trigger <value> — Search trigger source: user | agent.

dots tags

dots tags [options] [command]

Manage the company's custom tag categories — the per-company knowledge-classification facets rows can be tagged against.

dots tags create

dots tags create [options]

Create a custom tag category for the company (a no-code Customize surface). A duplicate key is a conflict.

Options:

• --category <key> — Category key (required): a lowercase slug starting with a letter, then letters / digits / underscores (max 32), e.g. methodology.
• --display-name <text> — Human-readable display name (required), e.g. Methodology.
• --description <text> — One-line description of what the category captures.
• --color <token> — Display color token for the category facet.
• --auto-detectable — Let the platform auto-detect this category on incoming rows.
• --ai-suggestable — Let the AI suggest values for this category.
• --facet-display — Show this category as a filter facet in the row UI (default on).
• --no-facet-display — Hide this category from the filter facets.
• --sort-order <n> — Display sort order among the categories (a non-negative integer).

dots tags update

dots tags update [options] <category>

Update one custom tag category without changing its key.

Arguments:

• <category> — Custom category key to update.

Options:

• --display-name <text> — New human-readable display name.

dots tags delete

dots tags delete [options] <category>

Permanently remove one custom tag category.

Arguments:

• <category> — Custom category key to remove.

Options:

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

dots tags merge

dots tags merge [options] <source> <target>

Merge one custom tag category into another, retagging rows and preserving the source as a canonical alias.

Arguments:

• <source> — Source custom category key to retire.
• <target> — Surviving custom category key.

Options:

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

dots tags list

dots tags list [options]

List the company's tag categories (built-in overrides + custom).

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.