Skip to content

dct search

Search dashboards by keyword with ranked results. Each hit includes title, summary, match score, source path, and matched query / chart names.

dct search [OPTIONS] QUERY

Arguments

Argument Description
QUERY Keywords to match against dashboard metadata.

Options

Flag Description
--json Output as JSON.
--limit INT Maximum results to return. Default 10, max 50 (values above 50 are clamped to 50).
--project-dir DIRECTORY Project root for resolving board paths and finding project config. [env var: DCT_PROJECT_DIR]

Examples

dct search revenue
dct search "monthly trends" --limit 5
dct search orders --json

What's searched

Each board is indexed on:

  • title: and description: fields
  • Chart titles and types
  • Query names and SQL bodies
  • Variable names and labels
  • Tags and other metadata

Hits are ranked by relevance.

When to use which search verb

If you want to find… Use
A dashboard about revenue dct search
A column or table in the warehouse dct query against INFORMATION_SCHEMA
A topic in the YAML reference docs dct docs --search
A packaged agent skill dct skills