rv-tool

Crates.iorv-tool
lib.rsrv-tool
version1.0.0-rc3
created_at2025-08-25 20:11:50.301381+00
updated_at2025-08-26 09:13:29.694307+00
description Non-invasive AI code review for any type of workflow
homepagehttps://github.com/gi-dellav/rv
repositoryhttps://github.com/gi-dellav/rv
max_upload_size
id1810092
size126,773
(gi-dellav)

documentation

README

rv

rv is a non-invasive AI code review for any type of workflow.

It works as a CLI tool easy to use and integrate in any kind of workflow and it allows to review the code that you are currently writing or code written by other developers on your project by extracting relevant information from your codebase and processing this data using LLMs.

Features

  • Unix philosophy
    rv follows the Unix philosophy by providing one minimalstic tool (<1k LoC) that does one thing (code review) well.
  • Cheap and low-latency
    rv is optimized to use cheap and low-latency models in order to allow for reviews that takes less than 5 seconds and cost about $0.001 (on average, tested with gpt-4o-mini)
  • Deterministic
    rv uses deterministic sampling (LLM's temperature set to 0 and other parameters tweaked) in order to avoid anomalies in the output.
  • Fully customizable
    rv is designed to give full freedom with its configuration file, allowing for different providers, LLMs and prompts
  • Semplicity of code
    rv is designed to be written using clean, understandable and safe (as in no unsafe instructions used) Rust code
  • Open source and non-monetized
    rv is released under the GPL license and we won't sell subscriptions, cloud credits or other form of monetized services to our end users

How To Install

From crates.io

Just run cargo install rv-tool --version 1.0.0-rc2 in order to install the last version (the specified version is only needed on testing releases); then, follow the "From the source" guide from the third step.

From the source

  1. Clone the repository
  2. Compile using cargo build --release
  3. Run for the first time (just rv) in order to generate the configuration file
  4. Edit the ~/.config/rv/config.toml file setting up provider, model and API key
  5. rv is now installed and ready! Run rv while you have staged edits (aka after git add) in order to get a code review of your current progress

NOTE: rv has been only tested on Linux; if possible try it on MacOS and Windows and open an issue with the results.

Future work

Milestones planned for the v1.0.0:

  • basic project context support (using README files, .rv_context and .rv_guidelines)
  • custom prompt support
  • raw mode support (selecting specific files or directory, skipping git integrations)
  • full git support (not only staged edits, but also commits, branches and PRs)

Milestones planned for the future:

  • ollama support for local inference
  • custom OpenAPI support
  • chat mode for turning rv into a chatbot-like assistant
  • actions mode for executing common git commands with one keystroke
  • full project context support (indexed references to other code or text files, full project reviews for better security and architectural reports)
Commit count: 64

cargo fmt