Commands¶
Run ravix --help to see the full tree; this page is a reference.
Auth¶
| Command | Effect |
|---|---|
ravix auth login |
Launch the device-code flow in your browser, store tokens in ~/.ravi/config.json. |
ravix auth status |
Report current identity + whether tokens are valid. |
ravix auth logout |
Remove stored credentials. |
~/.ravi/config.json is shared with the ravi CLI — same identity, same tokens.
Onboard¶
| Command | Effect |
|---|---|
ravix onboard |
One-shot: login + write default config + install + start the daemon + install the Claude Code plugin. Idempotent. |
ravix onboard --force |
Overwrite an existing config.yaml. |
ravix onboard --no-skills |
Skip installing the Claude Code plugin. |
See Quick start for what each step does.
Daemon lifecycle¶
| Command | Effect |
|---|---|
ravix daemon install |
Register a user-level service (LaunchAgent / systemd user unit) pointed at the current binary path. |
ravix daemon start |
Start the installed service. |
ravix daemon stop |
Stop the service. |
ravix daemon status |
Prints running / stopped / unknown. |
ravix daemon uninstall |
Remove the service registration. State under ~/.ravix/ is left in place. |
ravix daemon run |
Run the daemon in the foreground — useful for debugging. Ctrl-C exits cleanly. |
ravix daemon logs |
Print the daemon log file. |
ravix daemon logs -f |
Follow the log file (like tail -f). |
Log locations:
- macOS:
~/Library/Logs/ravix/ravix.log - Linux:
$XDG_DATA_HOME/ravix/logs/ravix.log(typically~/.local/share/ravix/logs/)
Rotation: 50 MB / 5 backups / 30 days via lumberjack.
Trust¶
| Command | Effect |
|---|---|
ravix trust <email> |
Add an email address to the from allowlist for the default claude-run rule. Restart the daemon to apply. |
Email reply¶
| Command | Effect |
|---|---|
ravix email reply <message-id> --body <html> |
Send a reply to the given message. Used by the ravix-reply Claude Code skill; you can also invoke it by hand. |
Flags on reply:
--body <html>(required) — HTML body. No<html>/<body>wrapper needed.--cc <address>(repeatable)--bcc <address>(repeatable)
Telemetry¶
| Command | Effect |
|---|---|
ravix telemetry status |
Show current opt-in state + distinct_id. |
ravix telemetry enable |
Opt in to telemetry. |
ravix telemetry disable |
Opt out. |
Telemetry is off by default. See Telemetry for the full data policy.
Version¶
| Command | Effect |
|---|---|
ravix --version |
Print version, commit, build date, and configured API URL. |