x uptime - System Uptime and Load

Enhanced uptime command with structured YAML output and cross-platform support.

Quick Start

# YAML format output (default)
x uptime

# Raw uptime command output
x uptime --raw

Features

• Structured YAML output: Easy to parse and read
• Load averages: 1, 5, and 15-minute trends
• Cross-platform: Linux, macOS, Windows (via cosmo/busybox)
• Auto-detection: Uses native, busybox, or cosmo backends

Output Fields

Commands

Examples

Basic Usage

# Default YAML output
x uptime

# Output example:
# time  : 14:32:10
# up    : 5 days, 3 hours, 27 minutes
# users : 2 users
# load  : 0.52, 0.58, 0.59

Raw Output

# Traditional uptime output
x uptime --raw
# 14:32:10 up 5 days, 3:27, 2 users, load average: 0.52, 0.58, 0.59

Parsing

# Extract uptime
x uptime | awk -F': ' '/^up/{print $2}'

# Get load average
x uptime | awk -F': ' '/^load/{print $2}'

Understanding Load Averages

Load averages indicate system busyness - the average number of processes waiting for CPU or I/O.

The three numbers show:

• 1 min: Short-term trend (immediate load)
• 5 min: Medium-term trend (recent history)
• 15 min: Long-term trend (sustained load)

Multi-Core Systems

Divide load by CPU core count:

# 4-core system with load 3.2
effective_load = 3.2 / 4 = 0.8  # Still has capacity

Platform Notes

Linux

• Uses native uptime command
• Full feature support

macOS

• Uses native uptime command
• Full feature support

Windows

• No native uptime command
• Automatically uses cosmo binary or busybox

Related

• Native uptime(1) manual page