Skip to main content

@webframp/system

v2026.04.22.1

Query local system diagnostics via shell commands for operational visibility.

Usage

# Create system diagnostics model
swamp model create @webframp/system sys-diag

# Get disk usage
swamp model method run sys-diag get_disk_usage

# Get memory info
swamp model method run sys-diag get_memory

# Get uptime and load averages
swamp model method run sys-diag get_uptime

# Get top processes by CPU
swamp model method run sys-diag get_processes

# Get network interfaces
swamp model method run sys-diag get_network_interfaces

# Get OS info
swamp model method run sys-diag get_os_info

Methods

  • get_disk_usage - Filesystem usage from df
  • get_memory - Memory and swap usage from free
  • get_uptime - Boot time, uptime string, and load averages
  • get_processes - Top 20 processes sorted by CPU usage
  • get_network_interfaces - Network interfaces and addresses from ip
  • get_os_info - OS release info and kernel version

Repository

https://github.com/webframp/swamp-extensions

Labels

systemlinuxdiagnosticsops

Contents

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @webframp/system

@webframp/systemv2026.04.12.1system/diagnostics.ts
get_disk_usageGet filesystem disk usage from df
get_memoryGet memory and swap usage from free
get_uptimeGet system boot time, uptime string, and load averages
get_processesGet top 20 processes sorted by CPU usage
get_network_interfacesGet network interfaces and addresses via ip
get_os_infoGet OS release information and kernel version

Resources

disk_usage(5m)— Filesystem disk usage
memory(5m)— Memory and swap usage
uptime(5m)— System uptime and load averages
processes(5m)— Top processes by CPU usage
network_interfaces(15m)— Network interfaces and addresses
os_info(1h)— Operating system information