rgctl v0.4.7

rgctl v0.4.7

rgBuilder is now rgctl. This release is the product rename plus a background HTTP+MCP daemon, stdio MCP for IDEs, and explicit --no-daemon mode for in-repo artifacts and CI.

Download rgctl from the assets below (not rg-build). Put it on your PATH, then:

rgctl --version
rgctl install --skill

Highlights

CLI rename: rgBuilder → rgctl

Before (v0.4.6)	Now (v0.4.7)
Binary rg-build	Binary rgctl
Crates rgbuilder-*	Crates rgctl-*
Artifacts .rgbuilder/	Artifacts .rgctl/ (auto-migrated from .rgbuilder/ / .rbuilder/)
Env RGBUILDER_*	Env RGCTL_* (legacy names still read for one release)
MCP tools rgbuilder_*	MCP tools rgctl_*
Agent skill .claude/skills/rgbuilder/	Agent skill .claude/skills/rgctl/ (and .cursor/skills/rgctl/)

Background daemon (default)

Most CLI commands auto-start a daemon on first use (stderr: no daemon found; starting). State lives under ~/.rgctl/ by default (override with --daemon-home or RGCTL_HOME).

• discover writes to ~/.rgctl/cache/{reponame}/.rgctl/ — not into your source tree.
• gql, blast-radius, metrics, and check (with -f json) route through the daemon when it is running.
• rgctl daemon start|stop|status|list — lifecycle and catalog.
• rgctl serve --daemon — background HTTP on 0.0.0.0:8080 with per-repo URLs under /{reponame}/ and optional /mcp HTTP endpoint.

The legacy blast-radius query.sock auto-connect path is retired (query_daemon.rs is quarantined).

--no-daemon mode

Opt out of the daemon when you want artifacts in the repo or need deterministic CI:

rgctl --no-daemon discover --languages java
# → writes {repo}/.rgctl/graph.snapshot.bin

Also: --fail-if-no-daemon (fail closed if the daemon is not already running) and RGCTL_NO_DAEMON=1.

Discover pitfall (fixed in docs): rgctl -r PATH discover . does not index PATH — the . uses shell cwd. Use cd repo && rgctl discover . or rgctl -r PATH discover (no trailing .).

MCP server (IDE integration)

Seven tools for agents in Cursor / Claude Code — shared service layer in rgctl-service, MCP crate rgctl-mcp:

Tool	Purpose
rgctl_status	Pipeline / artifact readiness
rgctl_query	GQL
rgctl_search	Semantic search
rgctl_impact	Blast radius
rgctl_metrics	PageRank / betweenness / communities
rgctl_cpg	Hybrid CPG (status, calls, pdg, slice, …)
rgctl_check	CI policy gate

Stdio (IDE): rgctl serve --mode mcp — JSON-RPC on stdin/stdout; auto-runs discover --full unless --no-pipeline.

HTTP (daemon): POST /mcp on the background daemon when MCP is enabled in config.

Guide: MCP Server

discover --full staged pipeline

One command runs three stages in process (queryable after stage 1):

1. Basic — index + analysis (snapshot ready for gql)
2. Deep — --with-cfg --with-dashboard --with-harmonic
3. Semantic — vocab semantic index

Status: GET /api/status and .rgctl/pipeline_status.json.

rgctl serve (foreground HTTP) no longer fails when the dashboard is missing — it binds, starts the full pipeline, and serves a preparing page until ready. Use serve --no-pipeline for the old fail-fast behavior.

Install

Platform	Asset
Linux x86_64	rgctl-0.4.7-x86_64-unknown-linux-gnu.tar.gz
macOS Apple Silicon	rgctl-0.4.7-aarch64-apple-darwin.tar.gz
macOS Intel	rgctl-0.4.7-x86_64-apple-darwin.tar.gz
Windows x86_64	rgctl-0.4.7-x86_64-pc-windows-msvc.zip

Verify: shasum -a 256 -c SHA256SUMS.txt (after extracting checksums file from the release).

Quick start

# Index (daemon cache by default)
cd your-repo
rgctl discover .

# Or from anywhere
rgctl -r /path/to/repo discover

# IDE MCP (.cursor/mcp.json)
# "args": ["-r", "/abs/path/to/repo", "serve", "--mode", "mcp"]

# CI / in-repo artifacts
rgctl --no-daemon -r /path/to/repo discover

Docs

• Discovering and Indexing — discover, daemon vs --no-daemon
• MCP Server — stdio + HTTP MCP
• User Guide · AGENTS.md · Install

Merged PRs

• #67 — rgctl rename, daemon, MCP service, discover --full, integration tests
• #68 — Windows windows-sys fix, user-guide harness, doc/command corrections, VHS tape

Compare

v0.4.6...v0.4.7

Upgrade from v0.4.6

1. Replace rg-build with rgctl on your PATH.
2. Existing .rgbuilder/ dirs migrate to .rgctl/ on first use.
3. Re-run rgctl install --skill for the renamed skill bundle.
4. Update MCP configs: tool names rgctl_*, args serve --mode mcp (not rgbuilder_*).
5. If you relied on in-repo .rgctl/, either use --no-daemon or point follow-up commands at the daemon cache path from discover JSON.

What's Changed

• MCP server, HTTP daemon, and rgBuilder → rgctl rename (v0.4.7) by @sshaaf in #67
• fixes for 0.4.7 by @sshaaf in #68

Full Changelog: v0.4.6...v0.4.7