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 { NextResponse } from "next/server";
import { verifyAuth } from "@/lib/agent/server";
import { getSessionActor } from "@/lib/auth/require-session";
import { apiError, invalidRequest, optionalString, readJson, requireString } from "@/lib/host/request-api";
import { audit } from "@/lib/host/audit-api";
import { rateLimited } from "@/lib/host/limits-api";
import { runCommand } from "@/lib/host/exec-api";
const EXEC_MAX = 60;
const EXEC_WINDOW_MS = 60_000;
export async function handlePostExecRun(req: Request): Promise<Response> {
if (!(await verifyAuth(req)))
return NextResponse.json({ error: "unauthorized" }, { status: 401 });
const actor = await getSessionActor();
if (rateLimited(`exec:${actor ?? "anon"}`, EXEC_MAX, EXEC_WINDOW_MS)) {
audit({ action: "exec.run", actor, ok: false, detail: "rate-limited" });
return NextResponse.json({ error: "Too many commands, slow down" }, { status: 429 });
}
const body = await readJson(req);
const cmd = requireString(body, "cmd");
if (cmd === null) return invalidRequest("cmd");
const cwd = optionalString(body, "cwd");
if (cwd === null) return invalidRequest("cwd");
try {
const result = await runCommand(cmd, cwd);
const blocked = result.code === 126 && result.stderr.startsWith("refused:");
audit({
action: blocked ? "exec.blocked" : "exec.run",
actor,
target: cmd,
ok: !blocked && result.code === 0,
detail: `exit ${result.code}${cwd ? ` @ ${cwd}` : ""}`,
});
return NextResponse.json(result);
} catch (e) {
audit({ action: "exec.run", actor, target: cmd, ok: false, detail: String(e) });
return apiError("exec/run", e);
}
}