ragctl

rag-ragctl

The ragctl control-plane CLI for AgentContextOS.

Install

ragctl is part of the AgentContextOS uv workspace. Once the workspace is bootstrapped (task bootstrap), the command is available on your PATH:

ragctl --help

Command groups

Group	Status	Purpose
config	✅ available	Validate and diff rag.yaml files (Step 0.4).
eval	✅ available	Run and inspect golden-set evaluations (Step 0.8).
traces	✅ available	Query distributed traces from Jaeger (Step 0.7).
version	✅ available	Print the installed ragctl version.
ingest	🚧 scaffold	Trigger ingestion via the gateway (lands in Step 1.10).
query	🚧 scaffold	Run a query against the gateway (lands in Step 3.1).
logs	🚧 scaffold	Tail structured logs (lands in Step 5.6).
tenant	🚧 scaffold	Manage tenants (lands in Step 6.1).
plugin	🚧 scaffold	Manage SPI plugins (lands in Step 1.1).
secret	🚧 scaffold	Manage tenant secrets (lands in Step 6.7).

Scaffold commands exit 0 and print which step delivers the real implementation.

Shell completion

ragctl ships with Typer-powered shell completion for bash, zsh, fish, and PowerShell:

# install completion for the current shell
ragctl --install-completion

# print the completion script (e.g. to inspect or pipe into a file)
ragctl --show-completion

See also

• docs/reference/ragctl.md — full command reference
• docs/guides/ragctl-quickstart.md — operator quickstart