Documentation
CLI Reference
All commands grouped by category. Run oxmgr --help or oxmgr <command> --help for inline help.
Runtime & Monitoring
| Command | Description |
|---|---|
| oxmgr list | Show all processes with status, CPU, RAM, uptime |
| oxmgr status <name> | Detailed process info including restart policy, limits, log paths |
| oxmgr logs <name> [-f] | Stream or show logs. --lines <n> for history |
| oxmgr ui | Interactive terminal UI with keyboard + mouse |
Lifecycle
| Command | Description |
|---|---|
| oxmgr start "<cmd>" --name <n> | Start a process. See start options below. |
| oxmgr stop <name> | Stop a running process |
| oxmgr restart <name> | Restart a process (resets crash-loop counter) |
| oxmgr reload <name> | Graceful reload (zero-downtime where supported) |
| oxmgr pull [name] | Git pull + reload/restart only if commit changed |
| oxmgr delete <name> | Stop and remove process from daemon state |
Start Options
All flags supported by oxmgr start. These correspond directly to oxfile.toml fields.
| Flag | Default | Description |
|---|---|---|
| --name <n> | Process name used in CLI commands | |
| --restart <policy> | on-failure | always | on-failure | never |
| --max-restarts <n> | 10 | Max consecutive auto-restarts |
| --crash-restart-limit <n> | 3 | Stop restarting after N crashes in 5 min. 0 = disabled |
| --cwd <path> | Working directory for the process | |
| --env KEY=VALUE | Environment variable (repeatable) | |
| --watch | false | Watch cwd and restart on file changes |
| --watch-path <path> | Explicit path to watch (repeatable). Requires --watch. | |
| --ignore-watch <regex> | Ignore paths matching regex during watch scans (repeatable). | |
| --watch-delay <s> | 0 | Restart debounce after file-watch change. Requires --watch. |
| --health-cmd <cmd> | Command polled to verify health | |
| --health-interval <s> | 30 | Seconds between health checks |
| --health-timeout <s> | 5 | Timeout for each health check |
| --health-max-failures <n> | 3 | Failures before restart |
| --wait-ready | false | Gate start/reload on health check readiness. Requires --health-cmd. |
| --ready-timeout <s> | 30 | Timeout for readiness check. Requires --wait-ready. |
| --kill-signal <signal> | SIGTERM | Signal sent to process on stop/reload. |
| --stop-timeout <s> | 5 | Grace period before force-kill |
| --restart-delay <s> | 0 | Delay between auto-restarts |
| --start-delay <s> | 0 | Delay before initial process start |
| --cluster | false | Node.js cluster mode |
| --cluster-instances <n> | all CPUs | Worker count (requires --cluster) |
| --namespace <name> | Group process under a namespace | |
| --max-memory-mb <n> | Memory limit in MB | |
| --max-cpu-percent <n> | CPU usage limit (%) | |
| --cgroup-enforce | false | Apply hard limits via Linux cgroup v2 at spawn time |
| --deny-gpu | false | Best-effort GPU disable via env vars |
| --pre-reload-cmd <cmd> | Command run before reload. Reload aborts if this fails. | |
| --reuse-port | false | Best-effort SO_REUSEPORT hint (macOS/Linux only) |
Config Commands
| oxmgr apply <path> [--env <profile>] [--only a,b] [--prune] | Apply oxfile config. --prune removes unmanaged processes. |
| oxmgr validate <path> [--env <profile>] | Validate oxfile before deploy. Great for CI. |
| oxmgr import <source> [--sha256 <hex>] | Import oxpkg bundle or ecosystem.config.json |
| oxmgr export <name> | Export process config as oxpkg bundle |
| oxmgr convert <ecosystem.json> --out <oxfile.toml> | Convert PM2 ecosystem JSON to oxfile.toml |
Interactive UI — Keyboard Shortcuts
Launch the TUI with oxmgr ui. Mouse supported — click to select, scroll to navigate.
| Key | Action |
|---|---|
| j / k or ↑↓ | Move selection up / down |
| n | Create new process |
| s | Stop selected |
| r | Restart selected |
| l | Reload selected |
| p | Pull selected (git pull + reload) |
| t | Preview latest log line |
| g / Space | Refresh now |
| ? | Show help overlay |
| Esc | Open / close menu |
| q | Quit |
Still have questions?
Open an issue or browse the source on GitHub.