Repo brief: watchexec/cargo-watch

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T04:38:10.372Z · commit 58e792b99fad

Verdict

Mixed — Stale — last commit 1y ago

• 10 active contributors
• CC0-1.0 licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

cargo-watch is a command-line tool that monitors your Rust project's source code for changes and automatically re-runs Cargo commands (like cargo check, cargo test, cargo build) whenever files are modified. It wraps the watchexec library (v1.17.2) and integrates with cargo_metadata to provide intelligent file filtering and build awareness specific to Cargo projects. Single-binary architecture: src/main.rs is the entry point, src/args.rs and src/options.rs parse CLI arguments via clap v2, src/watch.rs contains the core watch loop using the watchexec library, src/rustc.rs handles Rust compiler output parsing, and src/root.rs manages the Cargo project root detection. The binary is built…

Start here

Open these first:

• src/main.rs — Entry point that orchestrates argument parsing, logging setup, and the main watch loop—all contributors must understand the…
• src/watch.rs — Core watch loop logic that binds to watchexec library and handles file change events; critical for understanding how cargo…
• src/args.rs — Command-line argument definitions using clap; essential for understanding the CLI surface and what features are exposed.
• src/options.rs — Conversion from clap args to internal Options struct; bridges CLI layer with application logic.
• src/rustc.rs — Handles rustc output parsing and error filtering; critical for the core feature of watching Cargo builds.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/watchexec/cargo-watch.git
cd cargo-watch
cargo build --release
cargo run -- -x test

Daily commands:

cargo watch -x check
cargo watch -x test
cargo watch -c -x build

Run cargo watch --help for all options. The tool runs the Cargo subcommand specified after -x whenever watched files change.

Key cautions & unknowns

• Stale — last commit 1y ago
• Concentrated ownership — top contributor handles 78% of recent commits
• No environment setup required, but be aware: clap v2 has significantly different ergonomics than clap v4; migration would be substantial. The maintainer notes the project has 'four different syntaxes' for running…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.