Skip to content

dft search

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

dft 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 face paths and finding project config. [env var: DFT_PROJECT_DIR]

Examples

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

What's searched

Each face 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 dft search
A column or table in the warehouse dft query against INFORMATION_SCHEMA
A topic in the YAML reference docs dft docs --search
A packaged agent skill dft skills