Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
import { describe, expect, it } from "vitest";
import { parsePosixProcesses, parseWindowsProcesses, stats } from "./sys";
// The System Monitor polls /api/v1/sys/stats every 1500ms. Taking both /proc/stat
// samples inside one call made every one of those requests sleep 120ms; reusing
// the previous sample removes that for all but the first.
describe("stats", () => {
it("reuses the previous CPU sample instead of sleeping again", async () => {
const first = await timed(); // cold: pays the two-sample sleep
await sleep(250); // past REUSE_MIN_MS, so the cached sample is usable
const second = await timed();
expect(first.ms).toBeGreaterThanOrEqual(100);
expect(second.ms).toBeLessThan(100);
// Still a real reading, not a shortcut that skips the work.
expect(second.value.cpu.pct).toBeGreaterThanOrEqual(0);
expect(second.value.cpu.pct).toBeLessThanOrEqual(100);
expect(second.value.cpu.cores).toBeGreaterThan(0);
expect(second.value.mem.total).toBeGreaterThan(0);
});
it("returns a whole, sane payload", async () => {
const s = await stats();
expect(s.mem.used).toBeLessThanOrEqual(s.mem.total);
expect(s.disk.used).toBeLessThanOrEqual(s.disk.total);
expect(s.uptime).toBeGreaterThan(0);
});
});
const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
async function timed() {
const t0 = Date.now();
const value = await stats();
return { ms: Date.now() - t0, value };
}
describe("native process inventory", () => {
it("parses macOS ps columns and ranks recent CPU", () => {
const rows = parsePosixProcesses(" 42 /usr/bin/zsh 12.5 2048 S\n 7 WindowServer 45.1 102400 R\n");
expect(rows).toEqual([
{ pid: 7, name: "WindowServer", cpu: 45.1, mem: 100, status: "R" },
{ pid: 42, name: "/usr/bin/zsh", cpu: 12.5, mem: 2, status: "S" },
]);
});
it("parses Windows CIM sample, excludes idle, and normalizes cores", () => {
const output = JSON.stringify([
{ IDProcess: 0, Name: "Idle", PercentProcessorTime: 400, WorkingSet: 0 },
{ IDProcess: 12, Name: "powershell", PercentProcessorTime: 200, WorkingSet: 104857600 },
]);
expect(parseWindowsProcesses(output, 8)).toEqual([
{ pid: 12, name: "powershell", cpu: 25, mem: 100, status: "running" },
]);
});
});