Skip to content
xtarter
Blog

query

The query command searches tasks by natural language, so you do not need exact task IDs. Scoring runs locally, with no AI or network calls.

Usage

Section titled “Usage”
xtarterize query "<query>" [options]

Options

Section titled “Options”
Option Description Default
--json Output machine-readable JSON false
--limit <n> Maximum number of results 20
--threshold <n> Minimum relevance score (0-1) 0.1
--cwd <path> Target directory current directory

--quiet and --format are not supported; use --json for machine-readable output.

Examples

Section titled “Examples”
Terminal window
npx xtarterize@latest query "strict typescript"

Results are grouped by category, and each group prints a ready-to-run xtarterize add command.

JSON output
npx xtarterize@latest query "ci pipeline" --json
Rank an init plan
npx xtarterize@latest init --compose "react project with ci and linting"

init --compose reorders the plan by relevance without excluding any applicable task.

See also

Section titled “See also”