contributions are welcome. please review these principles before submitting a pull request.
- deterministic only: no frecency, no fuzzy guessing, no background indexing. 1:1 key-to-target mapping always.
- sub-millisecond execution: no network calls, no daemons, minimal startup overhead.
- restraint: zero decorative features or abstractions for single use-cases. keep the binary under 2mb.
- tokyo night truecolor: all ui colors must strictly adhere to the palette defined in
src/theme.rs. - lowercase aesthetic: all user-facing strings, cli help, and error messages remain lowercase. no emoji.
# run test suite
cargo test
# format check
cargo fmt --check
# lint check (zero warnings permitted)
cargo clippy --all-targets -- -D warnings
# build optimized release binary
cargo build --release- all unit tests pass.
cargo clippy --all-targets -- -D warningssucceeds with zero warnings.cargo fmt --checkproduces no diff.