cargo-refquiem

A cargo requiem for the refs your Rust code left behind.

cargo refquiem finds the Rust items, dependencies, features, binaries and examples your git history removed, and reports the comments, doc comments, string literals and Markdown that still name them, with what each most likely became. The wiki explains matching, configuration, reports and the Action in depth.

Usage

cargo install refquiem --locked
cargo refquiem                                 # every commit, against the working tree
cargo refquiem --base origin/main --head HEAD  # what a branch removed
cargo refquiem --json                          # the report as JSON
cargo refquiem --markdown > report.md         # findings with suggested actions, linked when the repository is on GitHub

The exit status is 0 when nothing is stale, 1 with findings and 2 on errors. A .refquiem.toml at the workspace root adds excludes and names never reported, a refquiem: allow(Name) comment silences one mention, and cargo refquiem --help lists every option.

GitHub Action

The action guide reviews each pull request with a suggested fix for every stale mention, pull requests from forks included.

Library

Depend on refquiem with default-features = false to drop the CLI, then call refquiem::run as the Library page shows. Coding agents get the same guidance from the refquiem skill.

npx skills add LucaCappelletti94/cargo-refquiem