search the files you already told your project about.

qfile is a Rust CLI for ranked search across configured folders. It keeps file search and agent memory close to the repo, without making command parsing own the product.

# .qfile

[search]
targets = [
  "notes",
  "~/Develop/vault",
]

$ qfile "thin cli boundary"

{"score":421.84,"file":"notes/architecture.md"}
{"score":219.11,"file":"vault/coding/rust/cli.md"}

configured search

Declare target folders once. qfile ranks Markdown and text matches by title, phrase, content, and folder signals.

agent memory

Store durable lessons as Markdown and recall only the memories relevant to the current task.

terminal first

Use JSON output for scripts, direct commands for agents, and a compact TUI when browsing by hand.

install

git clone https://github.com/silver-river-us/qfile
cd qfile
cargo install --path .

usage

qfile search "bounded context"
qfile tui
qfile memory remember "Search behavior belongs in the files context."
qfile memory recall "add agent memory hooks"