rgctl - Code knowledge graph for LLM agents.

Index once (discover), then ask callers, impact, communities, and slices — compact deterministic JSON for agents, not grepping the tree.

What the R stands for: Rust · Reachability · Rich graph (30+ typed relations).

rgctl discover .
rgctl -f json find --type function --limit 20
rgctl -f json callers MyService --depth 1
rgctl -f json blast-radius MyService

# Use with your favorite LLM agent
rgctl install --skill --tools cursor,claude,codex,agents

user-guide-cli.mp4

---

Try it (5 minutes)

1. Install

Release binary (recommended): download rgctl for your OS from
GitHub Releases, unpack it, put it on your PATH.

rgctl --version

Or build from source (Rust 1.99+):

git clone https://github.com/sshaaf/rgctl.git
cd rgctl
cargo build --release --bin rgctl
# If ort/ONNX link fails: add --no-default-features
export PATH="$PWD/target/release:$PATH"

Details, PATH, and troubleshooting: Installation.

2. Index the in-tree demo

cd rgctl-tests/ecommerce-java   # from this repo, or any project you care about
rgctl discover . --with-cfg

Artifacts land in {repo}/.rgctl/. Re-run discover after large code changes.

3. Ask the graph

# Inventory
rgctl -f json inventory --by type
rgctl -f json find --type function --limit 10

# Callers / callees
rgctl -f json callers ProductService --depth 1
rgctl -f json relations --edge calls --limit 20

# Impact before you edit a symbol
rgctl -f json blast-radius ProductService

Always prefer -f json for agents and scripts (JSON API). Do not scrape stderr.

---

Use with coding agents

Install the bundled pack (skills) into your IDE tooling:

rgctl install --skill --tools cursor,claude,codex,agents

Then: discover once → query with -f json. See Agent pack.
For your application repo, optionally paste USER_AGENTS_TEMPLATE.md as AGENTS.md.

---

What it does

You need…	Command
Build the graph	discover
Find symbols / inventory	find, inventory, status
Callers / edges	callers, callees, relations
“What breaks if I change X?”	blast-radius
CFG / data-flow / taint	slice, inspect, cpg, taint (need discover --with-cfg)
OSV / deps / OpenVEX	vuln triage, deps check, vuln analyze
Hotspots / clusters	metrics, communities
NL search over functions	semantic (opt-in index)
CI gates	check, pr-check
Snapshot compare	diff
Browser UI + HTTP API	discover --with-dashboard then serve

Step-by-step feature guides (CoolStore): docs/guides.
Concepts: Introduction. Full CLI walkthrough: User Guide.

---

Languages

Tier 1 plugins: C, C++, C#, Go, Groovy, Java, JavaScript, Kotlin, PHP, Puppet, Python, Ruby, Rust, TypeScript, plus markdown.

Support matrix is generated from *-ast-coverage.json — see Languages.

---

Docs

Doc	For
Installation	Install, verify, PATH
Introduction	What / why / capability map
Guides	Feature how-tos
User Guide	ecommerce-java + every command
JSON API	-f json shapes
Docs index	Full map
AGENTS.md	Contributing to this repo
CONTRIBUTING.md	Dev setup / PRs
Latest release	Changelog

---

License

MIT — see LICENSE.