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 os from "node:os";
import path from "node:path";
import { describe, expect, it } from "vitest";
import { appDir } from "./path-credentials";
import { assertDelegatedWritePath } from "./delegated-write";
describe("delegated write control-plane guard", () => {
it("blocks the live MSO checkout and prospective children", async () => {
await expect(assertDelegatedWritePath(path.join(appDir(), "package.json"))).rejects.toThrow(/control-plane/);
await expect(assertDelegatedWritePath(path.join(appDir(), "future", "script.sh"))).rejects.toThrow(/control-plane/);
});
it("blocks Git control files in any project", async () => {
await expect(assertDelegatedWritePath(path.join(os.tmpdir(), "project", ".git", "config"))).rejects.toThrow(/control-plane/);
await expect(assertDelegatedWritePath(path.join(os.tmpdir(), "project", ".git", "hooks", "post-checkout"))).rejects.toThrow(/control-plane/);
});
it("blocks user-systemd unit inputs", async () => {
await expect(assertDelegatedWritePath(path.join(os.homedir(), ".config/systemd/user/evil.service"))).rejects.toThrow(/control-plane/);
});
it("allows ordinary project content", async () => {
// Positive fixture: a prospective path in the real projects root, never created.
// os.tmpdir() is not portable here — under Hermes it lives inside ~/.hermes,
// which is a protected control-plane input, so that path belongs to the negative cases.
await expect(assertDelegatedWritePath(path.join(os.homedir(), "projects", "mso-delegated-write-fixture", "src", "index.ts"))).resolves.toBeUndefined();
});
it("blocks CLI launchers used by managed-app probes", async () => {
for (const dir of [".local/bin", ".bun/bin", ".hermes", ".openclaw"]) {
await expect(assertDelegatedWritePath(path.join(os.homedir(), dir, "hermes"))).rejects.toThrow(/control-plane/);
}
await expect(assertDelegatedWritePath(path.join(os.homedir(), ".local"))).rejects.toThrow(/control-plane/);
});
});