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 |
| Graph Query Language | gql | Query the code graph with Cypher-like syntax |
| 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 | Enforce architectural rules in your CI pipeline |
| HTTP Server and Dashboard | serve | Run an HTTP API and browser-based dashboard |
| Migration Planning | discover --export-migration-hints | Generate a dependency-aware migration roadmap |
| Agent Skill | install --skill | Teach AI agents to use rgctl for refactoring, migration, porting, and testing |
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
- Glossary -- definitions of key terms