CLI reference
Run urus --help or urus help <topic> for the in-terminal help (with rich topics for each command).
Global options
| Option | Meaning |
|---|---|
--non-interactive | Fail instead of prompting; combine with explicit flags (URUS_NON_INTERACTIVE=1 in the environment is equivalent). |
Commands (summary)
| Command | Purpose |
|---|---|
init | Ensure ~/.config/urus and registry exist |
add | Register a bot; optional venv; optional deps install command; install systemd unit |
edit | Change registry fields for a bot |
list | List registered bots |
delete | Remove registry entry and uninstall Urus-managed systemd unit (does not delete project files) |
start / stop | systemctl wrappers; --all where applicable |
restart | Same, plus optional deps when depsInstallCommand changed (or --install-deps) |
status | Table of bots + state; --json for machine-readable output |
logs | journalctl tail/follow |
config / cfg | Paths, version, settings; config get / config set |
version | Print package version |
JSON output
urus config --json— full config snapshoturus status --json—{ "cliVersion", "bots": [ { ...registry row, "systemd": { ... } } ] }urus cfg get … --json— subset of keys
Non-interactive add
Requires at least: --name, --runtime, --bot-dir, --entry-file. Optional: --deps-install-cmd, --python-hint, --python-no-venv, --install, --start.
See urus help add.