rgctl Guides
Practical, step-by-step guides for every major rgctl feature. Each guide uses the CoolStore application (example/coolstore) as a running example so you can follow along on a real Java EE codebase.
Guides
| Guide | Feature | Description |
|---|---|---|
| Discovering and Indexing a Codebase | discover | Build the knowledge graph from source code |
| Structured graph queries | find / callers / relations / … | Agent-facing graph exploration verbs |
| Blast Radius Analysis | blast-radius | Measure upstream impact before changing a function |
| Semantic Search | semantic | Natural-language search over function symbols |
| Graph Metrics | metrics | PageRank, betweenness, and community detection analytics |
| Community Detection | communities | Identify and label functional clusters in your codebase |
| Program Slicing | slice | Extract the minimal set of statements affecting a variable |
| Hybrid CPG | cpg | Combined call-graph + per-function CFG/PDG analysis |
| Inspecting CFG, PDG, and Dominance | inspect | Examine low-level control flow, data dependence, and dominator trees |
| Exporting Graphs | export | Serialize graph data to JSON, GraphML, Graphviz, Mermaid, or Obsidian |
| Markdown Context Graph | discover -l markdown · export | Index docs, Obsidian/OKF export, fixture feature tour (k8s-website scale example) |
| CI Policy Checks | check, pr-check | PR temporal gates and local policy checks |
| Pull Request Review | review paths, review check | Structural before/after call-path inspection and PR gates |
| HTTP Server and Dashboard | serve | Run an HTTP API and browser-based dashboard |
| Watch mode and incremental update | update, serve --watch | Keep the graph fresh without full rediscover |
| Migration Planning | discover --export-migration-hints | Generate a dependency-aware migration roadmap |
| Clone Detection | clones | Detect exact (Type-1), bloom, and sub-function fragment clones |
| Vulnerability and OSV Supply-Chain Analysis | vuln, deps, taint, security | End-to-end OSV advisory triage, manifest scanning, call-path reachability, and OpenVEX generation |
| Agent pack | CoolStore install walkthrough | Use cases; NL → rgctl skill → CLI |
Prerequisites
All guides assume you have rgctl installed. See the Installation guide to get started.
To follow the examples, clone the repository and navigate to the example project:
git clone https://github.com/konveyor-ecosystem/coolstore.git
cd coolstore
Related Resources
- User Guide -- full CLI reference and tutorial
- JSON API Reference -- schema details for
-f jsonoutput - Agent Recipes -- copy-paste recipes for LLM agents
- Introduction -- definitions of key terms