list / status / inspect

Commands for inspecting managed processes.

list

List all managed processes.

runix list [flags]
# Alias: runix ls

Examples

# Default table output
runix list
# ID  NAME    STATUS   PID     UPTIME  RESTARTS
# 1   api     running  48291   5m      0
# 2   worker  running  48292   5m      1

# JSON output
runix list --format json

# YAML output
runix list --format yaml

# Filter by state
runix list --filter running
runix list --filter crashed

# Filter by namespace
runix list --namespace production

# Filter by runtime
runix list --runtime go

# Filter by tag
runix list --tag backend

Flags

Flag	Short	Default	Description
--format	-f	table	Output format: table, json, yaml
--filter	-F		Filter by state: running, stopped, crashed, errored, all
--namespace	-N		Filter by namespace
--runtime	-r		Filter by runtime: go, python, node, bun
--tag			Filter by tag

Table Columns

Column	Description
ID	Numeric process ID
NAME	Process name
STATUS	Current state
PID	OS process ID (or - if not running)
UPTIME	Time since last start
RESTARTS	Number of restarts

status

Show detailed status of a single process.

runix status <id|name> [flags]

Examples

# Text output
runix status api

# JSON output
runix status api --format json

Flags

Flag	Short	Default	Description
--format	-f	text	Output format: text, json

Text Output Fields

ID:              abc123-def456-...
Name:            api
Runtime:         go
State:           running
PID:             48291
Exit Code:       0
Restarts:        0
CPU:             2.3%
Memory:          45.2M
Uptime:          5m30s
Created:         2025-01-15 10:30:00
Started:         2025-01-15 10:30:01
Entrypoint:      ./cmd/api
Args:            --port 8080
Cwd:             /home/user/project
Restart Policy:  always
Max Restarts:    10

inspect

Display detailed process information including config, environment, and recent logs.

runix inspect <id|name> [flags]

Examples

# Show details with last 20 log lines
runix inspect api

# Show details with 50 log lines
runix inspect api --logs 50

# Hide log lines
runix inspect api --logs 0

# JSON output
runix inspect api --format json

Flags

Flag	Short	Default	Description
--logs		20	Number of log lines to show (0 to hide)
--format	-f	text	Output format: text, json

Text Output

 Name:            api
 Namespace:       production
 ID:              1
 Internal ID:     abc123-def456-...
 PID:             48291
 Status:          running
 Uptime:          5m30s
 Restarts:        0
 Runtime:         go
 Script:          ./cmd/api
 Args:            --port 8080
 Log stdout:      ~/.runix/apps/api/stdout.log
 Log stderr:      ~/.runix/apps/api/stderr.log
 Env:             PORT=8080, LOG_LEVEL=info

--- Last 20 lines ---
2025-01-15 10:35:00 [out] Server listening on :8080
2025-01-15 10:35:01 [out] Connected to database
...

describe (deprecated)

runix describe is deprecated. Use runix inspect instead:

# Old (deprecated, hidden)
runix describe api

# New
runix inspect api