vvv reads declarations, identifiers, and imports. Rename follows references resolved
through module paths, and move rewrites paths it can resolve. Mutations preview by
default; --apply writes a checked plan and records an undo entry. Resolution and
failure-recovery limits are specified in the guide.
Install
Prebuilt binaries for Linux (x86_64, aarch64), macOS (x86_64, aarch64) and
Windows are attached to each release.
[!NOTE] The binary is
vvv. The default build includes Rust, TypeScript and the picker. To install a subset, name the features, e.g.--no-default-features --features rust,tui.
Commands
Every command runs against the current directory (-C <dir> picks another) and prints
human output (--json prints the machine-readable result).
Find
Understand
Change
[!NOTE] A changing command previews and stops.
--applywrites the plan,--diffprints the full patch of every file, and--selectacts on chosen rows only.
Output
Every command draws from one set of marks:
| mark | meaning |
|---|---|
● |
a declaration |
○ |
a use, not a declaration |
→ ← |
an import / imported by |
↗ |
a re-export |
✓ ? ✗ |
refers to the declaration / can't tell / another one |
± |
a structural edit: a mod line, a visibility |
! |
left to you, with the reason |
∅ |
nothing |
+N |
the match continues for N more lines |
Rows are numbered in the order printed; those numbers are what --select takes.
Documentation
- docs/guide.md — every command in detail, and the full mark legend.
- docs/protocol.md — the JSON contract.
- docs/architecture.md — the crates and their rules.
- CHANGELOG.md — what changed in each release.
- CONTRIBUTING.md — build, test and send a change.