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 { afterEach, describe, expect, it } from "vitest";
import { childEnv } from "./child-env";
const SECRETS = ["OS_SESSION_SECRET", "OS_LOGIN_PASSWORD", "OS_BROWSER_SECRET", "OS_AGENT_TOKEN", "ANTHROPIC_API_KEY"];
const saved: Record<string, string | undefined> = {};
afterEach(() => {
for (const k of Object.keys(saved)) {
if (saved[k] === undefined) delete process.env[k];
else process.env[k] = saved[k];
}
});
describe("childEnv (secret scrub for spawned shells)", () => {
it("strips every app secret from the child environment", () => {
for (const k of SECRETS) {
saved[k] = process.env[k];
process.env[k] = "super-secret";
}
const env = childEnv();
for (const k of SECRETS) expect(env[k]).toBeUndefined();
});
it("preserves NODE_ENV, PATH and non-secret OS_* config", () => {
saved.OS_FS_READ_ROOTS = process.env.OS_FS_READ_ROOTS;
process.env.OS_FS_READ_ROOTS = "/srv";
const env = childEnv();
for (const part of (process.env.PATH ?? "").split(":")) expect(env.PATH?.split(":")).toContain(part);
expect(env.NODE_ENV).toBe(process.env.NODE_ENV);
expect(env.OS_FS_READ_ROOTS).toBe("/srv"); // bounds config is not a secret
});
it("strips secret-shaped vars by pattern so new secrets don't silently leak", () => {
const leaky = ["OS_UNSPLASH_ACCESS_KEY", "MODELS_LIVE_OPENAI_KEY", "SOME_TOKEN", "DB_PASSWORD", "APP_SECRET", "OS_FUTURE_THING"];
for (const k of leaky) {
saved[k] = process.env[k];
process.env[k] = "leak-me";
}
const env = childEnv();
for (const k of leaky) expect(env[k]).toBeUndefined();
});
it("never emits undefined values", () => {
const env = childEnv();
expect(Object.values(env).every((v) => typeof v === "string")).toBe(true);
});
it("adds owner CLI directories to PATH without duplicates", () => {
saved.HOME = process.env.HOME;
saved.PATH = process.env.PATH;
process.env.HOME = "/home/tester";
process.env.PATH = "/usr/bin:/home/tester/.bun/bin";
const env = childEnv();
expect(env.PATH?.split(":").slice(0, 2)).toEqual(["/home/tester/.local/bin", "/home/tester/.bun/bin"]);
expect(env.PATH?.split(":").filter((part) => part === "/home/tester/.bun/bin")).toHaveLength(1);
});
});