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 { execFileSync, spawnSync } from "node:child_process";
import fs from "node:fs";
import os from "node:os";
import path from "node:path";
import { describe, expect, it } from "vitest";
const appVersion: string = JSON.parse(fs.readFileSync(path.join(__dirname, "../package.json"), "utf8")).version;
const cli = [
fs.readFileSync(path.join(__dirname, "../bin/mso"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/cli/onboarding.sh"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/cli/onboarding-ai.sh"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/mso-cli-agent.sh"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/cli/ai-provider-catalog.sh"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/cli/ai-provider-auth.sh"), "utf8"),
fs.readFileSync(path.join(__dirname, "../scripts/cli/transport.sh"), "utf8"),
].join("\n");
describe("terminal onboarding contract", () => {
it("keeps API keys out of curl argv", () => {
expect(cli).toContain('tty_secret "Paste $provider API key: "');
expect(cli).toContain("stty -echo < /dev/tty");
const start = cli.indexOf("secret_post() {");
const end = cli.indexOf("\n}\n\ntty_ok()", start);
const secretPost = cli.slice(start, end);
expect(secretPost).toContain("-d @-");
expect(secretPost).toContain('printf \'%s\' "$body" | curl');
expect(secretPost).not.toContain('-d "$body"');
expect(cli).toContain('secret_post "/api/config" "$body"');
});
it("discovers AI platforms dynamically while keeping OAuth and API-key auth distinct", () => {
expect(cli).toContain('jget "/api/models/providers"');
expect(cli).toContain('tui_select "Connect AI platform"');
expect(cli).toContain("OpenAI ChatGPT");
expect(cli).toContain("Subscription · device OAuth");
expect(cli).toContain("OpenCode Zen");
expect(cli).toContain('tty_secret "Paste $provider API key: "');
expect(cli).toContain("FREE means the live catalog explicitly reports zero input + output token cost");
});
it("keeps -y minimal instead of selecting external accounts or installs", () => {
expect(cli).toContain("AI provider skipped (-y keeps external accounts unconfigured)");
expect(cli).toContain("response preset left unchanged (-y keeps existing/default settings)");
expect(cli).toContain("optional managed apps skipped (-y uses minimal defaults)");
expect(cli).toContain("none installed automatically; run: mso skills install ponytail caveman rtk -y");
});
it("bootstraps onboarding against a verified loopback runtime without asking for approval twice", () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "mso-onboard-cli-"));
const bin = path.join(root, "bin");
const envFile = path.join(root, ".env.local");
const store = path.join(root, "devices.json");
const fakeCurl = path.join(bin, "curl");
fs.mkdirSync(bin, { mode: 0o700 });
fs.writeFileSync(envFile, "OS_LOGIN_PASSWORD=fixture-password\nOS_SESSION_SECRET=fixture-session-secret-long-enough\n", { mode: 0o600 });
fs.writeFileSync(fakeCurl, `#!/bin/sh
case "$*" in
*api/auth/login*) printf '{"success":true}\n200' ;;
*api/auth/me*) printf '{"role":"owner"}\n200' ;;
*) printf '{"status":"ok","buildId":"fixture","runtimeInstanceId":"fixture","version":"${appVersion}"}\n' ;;
esac
`, { mode: 0o700 });
try {
const out = execFileSync(path.join(__dirname, "../bin/mso"), ["--base", "http://127.0.0.1:4555", "onboard", "-y"], {
encoding: "utf8",
env: { ...process.env, HOME: root, PATH: `${bin}:${process.env.PATH}`, MSO_ENV: envFile, OS_DEVICE_STORE: store,
MSO_GATEWAY_CURL: fakeCurl, MSO_GATEWAY_STATE_DIR: path.join(root, "gateway-state") },
});
expect(out).toContain("approved this local CLI device");
expect(out).toContain("verified local MSO runtime at http://127.0.0.1:4555");
expect(out).toContain("Onboarding complete.");
expect(Object.keys(JSON.parse(fs.readFileSync(store, "utf8")).approved)).toHaveLength(1);
} finally { fs.rmSync(root, { recursive: true, force: true }); }
});
it("promotes a CLI id that is present in pending instead of mistaking it for approved", () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "mso-onboard-pending-cli-"));
const bin = path.join(root, "bin");
const envFile = path.join(root, ".env.local");
const store = path.join(root, "devices.json");
const devFile = path.join(root, "cli.device.id");
const fakeCurl = path.join(bin, "curl");
const device = "c".repeat(32);
fs.mkdirSync(bin, { mode: 0o700 });
fs.writeFileSync(devFile, device, { mode: 0o600 });
fs.writeFileSync(envFile, "OS_LOGIN_PASSWORD=fixture-password\nOS_SESSION_SECRET=fixture-session-secret-long-enough\n", { mode: 0o600 });
fs.writeFileSync(store, JSON.stringify({ approved: {}, pending: { [device]: { label: "mso cli", firstSeen: 1, lastSeen: 1, ip: "127.0.0.1", attempts: 1 } } }));
fs.writeFileSync(fakeCurl, `#!/bin/sh
case "$*" in
*api/auth/login*) body='{"success":true}' ;;
*api/auth/me*) body='{"authenticated":true,"role":"owner"}' ;;
*) body='{"status":"ok","service":"mso","buildId":"fixture","buildSha":"abcdef1","runtimeInstanceId":"fixture","version":"${appVersion}"}' ;;
esac
case "$*" in *'-w '*) printf '%s\n200' "$body" ;; *) printf '%s' "$body" ;; esac
`, { mode: 0o700 });
try {
const out = execFileSync(path.join(__dirname, "../bin/mso"), ["--base", "http://127.0.0.1:4555", "onboard", "-y"], {
encoding: "utf8",
env: { ...process.env, HOME: root, PATH: `${bin}:${process.env.PATH}`, MSO_ENV: envFile, OS_DEVICE_STORE: store,
MSO_DEVICE_FILE: devFile, MSO_GATEWAY_CURL: fakeCurl, MSO_GATEWAY_STATE_DIR: path.join(root, "gateway-state") },
});
expect(out).toContain("approved this local CLI device");
const parsed = JSON.parse(fs.readFileSync(store, "utf8"));
expect(parsed.approved[device]).toMatchObject({ label: "mso cli", role: "owner" });
expect(parsed.pending[device]).toBeUndefined();
} finally { fs.rmSync(root, { recursive: true, force: true }); }
});
it("reports a down runtime instead of falsely asking an already-approved device to approve again", () => {
const root = fs.mkdtempSync(path.join(os.tmpdir(), "mso-login-down-"));
const bin = path.join(root, "bin");
const envFile = path.join(root, ".env.local");
fs.mkdirSync(bin, { mode: 0o700 });
fs.writeFileSync(envFile, "OS_LOGIN_PASSWORD=fixture-password\n", { mode: 0o600 });
fs.writeFileSync(path.join(bin, "curl"), "#!/bin/sh\nexit 7\n", { mode: 0o700 });
try {
const result = spawnSync(path.join(__dirname, "../bin/mso"), ["--base", "http://127.0.0.1:4555", "login"], {
encoding: "utf8", env: { ...process.env, HOME: root, PATH: `${bin}:${process.env.PATH}`, MSO_ENV: envFile },
});
expect(result.status).not.toBe(0);
expect(result.stderr).toContain("MSO runtime is not reachable");
expect(result.stderr).not.toContain("approve this device");
} finally { fs.rmSync(root, { recursive: true, force: true }); }
});
});