Files
bare-operating-system/packages/bare-os-coreutils/man/pages/baretop.json
T
2026-04-05 17:38:46 -04:00

52 lines
3.7 KiB
JSON

{
"name": "baretop",
"section": 1,
"title": "baretop",
"synopsis": [
"baretop [OPTION]... [OPERAND]..."
],
"description": "Full-screen terminal dashboard (htop-inspired) over /proc/bare_os/*, metrics_live, and optional ctx fast paths. The btop binary is the same bundle. Logical process PIDs come from process_table.json (schema 8 when extended fields are present) — not host OS PIDs. Tabs: overview, processes, initd, network, features, diagnostics, operator (omit with BARE_TOP_TAB_MERGE=netop), pear, catalog, host, cpu, mem, disk. Overview uses a pinned HUD and scrollable sections; BARE_TOP_OVERVIEW_COMPACT and BARE_TOP_OVERVIEW_SECTIONS tune sections. On overview, press ' then a digit 1-9 or 0 (10th) to jump scroll to the Nth visible section. Line-diff updates: default incremental patching when TERM is capable; BARE_TOP_FULL_REDRAW=1 opts out. Snapshot batch includes process_io.json, process_threads.json, process_maps.json when the booter exposes them (see BARE_TOP_SNAPSHOT_PROC_ENTRIES). See src/baretop.js --help for the full environment list.",
"options": [],
"environment": [
"BARE_TOP_CONFIG_PATH — or ~/.config/baretoprc (JSON: theme, interval, keys, prefs).",
"BARE_TOP_PERSIST=1 — write back non-security prefs on quit when supported.",
"BARE_TOP_INTERVAL_MS — refresh period (ms).",
"BARE_TOP_INCREMENTAL — 0 off; 1 soft home; 2 line-diff (default ~2 when TERM ok).",
"BARE_TOP_FULL_REDRAW=1 — disable default incremental terminal patches.",
"BARE_TOP_LINE_HASH=1 — hash long lines in incremental diff.",
"BARE_TOP_SNAPSHOT_LITE=1 — smaller bareOsReadBareTopSnapshot batch.",
"BARE_TOP_SNAPSHOT_LITE_AUTO=1 — auto lite after sustained slow fetches.",
"BARE_TOP_TAB_MERGE=netop — merge operator summary into the network tab.",
"BARE_TOP_GRAPH_MODE — unicode | ascii | braille.",
"BARE_TOP_TRUECOLOR_CPU=1 — 24-bit CPU bar hints when COLORTERM=truecolor; NO_COLOR disables color.",
"BARE_TOP_FILTER_REGEX=1 — /…/ process filter; BARE_TOP_FILTER_INVERT=1 inverts match.",
"BARE_TOP_SORT_PPID_TIE=1 — tertiary process sort by ppid when tree off.",
"BARE_TOP_PROC_NAME_WIDTH — adjust process NAME column width (delta, clamped).",
"BARE_TOP_PROC_COL_SEP=1 — Unicode column separators in the process table.",
"BARE_TOP_MINIMAP=1 — scroll minimap on long lists.",
"BARE_TOP_PROFILE=1 — throttled compose/emit/fetch timing in the UI.",
"BARE_TOP_LAYOUT — stacked | even | htop | btop.",
"BARE_TOP_THEME — dark | light | none | gruvbox | nord | solarized.",
"BARE_TOP_OVERVIEW_COMPACT=1 — hide low-priority overview sections.",
"BARE_TOP_OVERVIEW_SECTIONS — comma list of section tokens.",
"BARE_TOP_PROC_SORT — pid | name | state | time | nice | pri | cpu.",
"BARE_TOP_NET_FILTER=1 — / filter applies on network tab.",
"BARE_TOP_CMD_ELLIPSIS_MIDDLE=1 — middle-ellipsis long process names.",
"BARE_TOP_MOUSE=1 — SGR mouse (wheel; row click; double-click opens process detail).",
"BARE_TOP_SCROLL_REGION=1 — DECSTBM scroll region (experimental; see in-app help).",
"BARE_TOP_EXPORT_REDACT=1 — omit fileTexts from JSON export.",
"BARE_TOP_HEALTH_DETAIL=1 — show health score penalty breakdown.",
"BARE_TOP_DEBUG_TIMINGS=1 — throttled fetch/draw timing on stderr.",
"BARE_TOP_FETCH_EWMA=1 — reduce parallel /proc batch reads when recent fetches are slow.",
"BARE_TOP_LAYOUT_AUTO=1 — use even layout when terminal is wide.",
"bareOsReadBareTopSnapshot — may include metricsLiveText to skip a separate metrics_live read.",
"ctx.bareOsRenice — optional; renice UI shows unsupported when absent."
],
"keywords": [
"baretop",
"btop",
"bare-os",
"coreutils"
]
}