fux-search

Search a committed Fux document index with fux ask, find, and lexical verbs.

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/arpitarya/fux --skill fux-search-arpitarya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fux-search
Source: https://github.com/arpitarya/fux/tree/main/.agents/skills/fux-search
Command: npx skills add https://github.com/arpitarya/fux --skill fux-search-arpitarya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Searching a git-committed Fux knowledge index requires knowing which verb, flags, and JSON fields to use, and how to interpret confidence bands so you never cite a document the index cannot actually support. ## Core Features & Use Cases - Ranked document search: Run fux ask for judged candidates with --json --band, or fux find for bare paths to pipe into other tools, with --under, --phrase, and --all filters. - Confidence-aware answers: Read the confidence block (band, answerable, missing) to know when to answer, when to hedge on partial, and when to abstain on weak or none. - Vocabulary gap recovery: Use -q phrasings fused by RRF or write your own --expand passage when the corpus uses different words than the question. - Ranking diagnostics: Use --why, --explain, and the frozen fux lexical baseline to understand why a document ranked or whether config files changed results. - Use Case: A teammate asks "where is the rollback procedure documented?" You run fux ask "rollback procedure" --json --band, get a grounded band with docs/deploy.md and a Rollback procedure heading, and cite it confidently. ## Quick Start Ask the assistant to search the Fux index for how to roll back a release using fux ask with JSON output and the confidence band enabled.

Frequently Asked Questions about fux-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search a Fux index from the command line?▼

Run fux ask "<query>" --json --band for ranked documents with a confidence block, or fux find "<query>" for bare paths to pipe into other tools. Both verbs are read-only, offline, and rank documents from the committed index.

What is the difference between fux ask and fux find?▼

fux ask returns a full JSON payload with scores, headings, confidence, and related documents for results you judge yourself. fux find prints bare locations on stdout for piping, and adds folder (--under), phrase (--phrase), and --all filters.

Why did fux ask return no confident matches?▼

A band of none means no query terms scored, and weak means the top two results could not be separated; both carry answerable: false. Check the missing field for terms absent from the corpus, retry with the corpus's vocabulary or an --expand passage, and abstain if the band stays weak.

When should I use fux lexical instead of fux ask?▼

Use fux lexical only when you need a frozen BM25F baseline, such as comparing a ranking change or checking whether a result came from the words or the graph tier. For ordinary questions use fux ask, since lexical omits the graph stage by design.

Can fux ask give me exact line numbers for an answer?▼

No. fux ask and fux find return document locations and matched headings, never line ranges. For exact cited lines with freshness verification, use the fux answer verb covered by the fux-answer skill.