Lists and runs commands from the rx registry. Covers rx list, rx run, rxx direct-run, and registry inspection. Triggers on "list rx commands", "what's in the rx registry", "run a script with rx", "rx run preflight", "show installed rx scripts", "query the rx registry".
The rx registry (~/.config/rx/registry.json) tracks all installed commands. Use rx list
to inspect it and rx run to execute commands from it. Always run these via Bash on the
user's behalf.
rx list
Output is tab-delimited: name description installed-path source
If description is not set, the column shows -.
rx run <name>
# Pass args after --
rx run <name> -- --verbose
rx run resolves the command from the registry and executes it through the correct runtime
adapter for its stored tag.
runtimerxx ./scripts/preflight.sh
rxx ./scripts/preflight.rs -- --arg value
rxx applies the same shebang validation and runtime selection as rx run but does not
touch the registry.
rx list via Bash.rx list output.rx run <name> (with any args) via Bash.Read the JSON file directly if structured inspection is needed:
cat ~/.config/rx/registry.json
Or with $XDG_CONFIG_HOME set:
cat "${XDG_CONFIG_HOME:-$HOME/.config}/rx/registry.json"
Each entry contains:
| Field | Type | Description |
|---|---|---|
name | string | Installed command name (filename stem) |
source | string | Original install source (path or URL) |
install_path | string | Absolute path of installed script |
runtime | string | rs, py, js, ts, sh, zsh, fish, nu, rb |
description | string | null | Optional description (currently unset by install) |
~/.config/rx/bin (or custom install dir) is
on $PATH.install_path.rx install <source> to update the entry.