Skip to content

Dataface Documentation

`dft search`

`dft search`¶

Search dashboards (faces) 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.
`--project-dir PATH`	Project directory containing dashboards.

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 schema-search`
A topic in the YAML reference docs	`dft docs --search`
A packaged agent skill	`dft skills`