Get started

Install rgctl

Prefer a release binary for day-to-day use. Build from source when you need the latest main. Pull Git LFS only if you use the optional code-daemon semantic embedder.

Option A — GitHub Releases

Download the latest asset for your platform from Releases, put rgctl on your PATH, then install the agent skill into the repo you will index:

$ rgctl --version
$ rgctl install --skill

That writes .claude/skills/rgctl/ and .cursor/skills/rgctl/. See the agent skill guide.

Open releases

Option B — Build from source

git clone https://github.com/sshaaf/rgctl.git
cd rgctl
# Optional: only if you use `semantic index --embedder code-daemon` (~206 MB)
git lfs pull
cargo build --release --bin rgctl
./target/release/rgctl --version

First hour

Use the in-tree rgctl-tests/ecommerce-java fixture (canonical walkthrough in the User Guide).

cd rgctl-tests/ecommerce-java
$ rgctl discover .
$ rgctl -f json gql --macro-name all_functions unused | jq '.count'
$ rgctl -f json blast-radius "priceShoppingCart" --depth 2

Dashboard and migration JSON are opt-in: add --with-dashboard / --export-migration-hints.

Read the guides Docs hub Try demos User Guide on GitHub