Rust · terminal-native · macOS

Find files before your flow breaks.

Vicaya is a lightweight developer file finder for filenames, paths, and metadata. Query it from the CLI, move through results in the TUI, and compose exact paths with the tools you already use.

See it in action GitHub

rust: native speed
repos: ignore-aware
json: composable output

What it is

A file finder for terminals, scripts, and coding agents.

CLI

Composable paths

Plain, table, and JSON output for shells, fzf, jq, and agents.

TUI

Interactive file finding

Ranked results, preview, scoped navigation, and an action palette.

daemon

Local catalog

Tracks filenames, paths, size, and modification time on your machine.

Simple mental model

Small stack. Same answers everywhere.

vicaya CLI json · plain · table

rakshaka daemon filesystem catalog

vicaya-tui TUI preview · scope · act

Developer workflow

Developer trees are noisy. Vicaya ranks for that.

It is built for finding project files quickly, not for searching inside file contents.

rank Exact, prefix, substring, abbreviation, recency, and scope-aware ordering.

scope Search globally, then narrow to the repo or subtree you are working in.

filter Use type:, ext:, path:, mtime:, and size:.

ignore Honor .gitignore, .ignore, and .git/info/exclude.

Why Vicaya

Path discovery for developer machines.

Terminal-native

Built for code paths, shell workflows, scripts, and automation.

Content-search companion

Find the file with Vicaya; search inside it with rg.

Ranked source

Use it as the ranked source for fzf, shells, and custom scripts.

Local workflow

Daemon, index, preview, and results stay on your machine.

Real screenshots

CLI precision. TUI flow.

vicaya CLI showing table and plain search results — **CLI search** Fast path output for humans, scripts, and agents.

vicaya-tui showing a theme search with ranked results and preview pane — **TUI search + preview** `prashna`, `phala`, `purvadarshana`.

vicaya-tui kriya-suchi action palette filtered to preview actions — **Action palette** Filter kriyas from home row.

vicaya-tui drishti switcher showing file and directory views — **View switcher** Move between drishti modes.

Stay current: vicaya upgrade updates to the latest release.

vicaya --version
vicaya upgrade --check
vicaya upgrade

version.json GitHub releases