system_status

System Status Skill

Check system health metrics without leaving your workflow. Returns structured data about disk usage, memory, running processes, and system uptime.

Available Actions

Published Function: machine_vitals()

An in-process read for callers that want data, not text - the host API's /v1/machine route proxies it verbatim and BAUD's phone draws it (FPLAN-0561).

from aipass.skills.lib.system_status import handler
vitals = handler.machine_vitals()

• {"ok": True, "schema": 2, "sampled_at": ...} plus nine sections: cpu, load, memory, swap, temp, fan, network, processes, battery (schema 1 had the first eight). Each carries available, reason, sentence, detail beside its values. Never raises for a reading; a value the host cannot give is None, never a zero.
• Whole-function refusal: {"ok": False, "reason", "detail"} with psutil_missing or switched_off (the off-switch is consulted, and an unreadable switch state fails closed).
• Reason codes (closed set, one sentence each in REASONS): platform, no_sensor, no_allowlisted_sensor, read_failed, warming, no_range, switched_off, psutil_missing.
• cpu carries percent and window_s, plus cores (busy percent per logical CPU, in index order), logical and physical (the counts) and mhz / mhz_max (frequency now and its ceiling). One cpu_times(percpu=True) sample per read: the headline is summed from the same per-CPU deltas as the cores, so the two agree. percent and cores are None while warming (and when the CPU count changed between samples); the counts and frequency are instant readings and are published even then. No frequency on a host is None, never 0.
• CPU temperature and fans come from allowlists keyed by chip and label (coretemp / Package id 0; applesmc fans). The fan range is a read-only Linux sysfs read of fanN_min / fanN_max.
• battery carries percent, plugged, state (charging, discharging, full or unknown), seconds_left, low and critical. A host whose psutil.sensors_battery() answers None is no_sensor; a psutil without the function is platform. seconds_left is None on psutil's POWER_TIME_UNLIMITED / POWER_TIME_UNKNOWN, and detail names which. state is the kernel's /sys/class/power_supply/BAT*/status word on Linux when it is one of the three (any other word is unknown), else derived from plugged and percent. low / critical are UPower's PercentageLow / PercentageCritical from /etc/UPower/UPower.conf on Linux (UPower's 20 / 5 when the file leaves a key out); no file, or a time-based policy, is None - a face tones only against a line the host published.