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 { json } from "@/lib/api/route";
import { getSessionContext } from "@/lib/auth/require-session";
import { getAgentVault, syncAgentVault } from "@/lib/host/agent-vault-api";
import { audit } from "@/lib/host/audit-api";
import { rateLimited } from "@/lib/host/limits-api";
import { readSetupJson } from "@/lib/infra/setup-http";
const headers = { "Cache-Control": "private, no-store" };
const failure = (error: unknown, status = 400) =>
json(
{ error: error instanceof Error ? error.message.slice(0, 300) : "Vault request failed" },
{ status, headers },
);
export async function handleGetAgentVault(req: Request) {
const context = await getSessionContext();
if (!context) return failure(new Error("unauthorized"), 401);
if (context.role !== "owner") return failure(new Error("owner_required"), 403);
if (rateLimited(`agent-vault:read:${context.session.device_id}`, 60, 60_000))
return failure(new Error("rate_limited"), 429);
try {
const url = new URL(req.url);
const project = url.searchParams.get("project") ?? undefined;
const note = url.searchParams.get("note") ?? undefined;
return json(await getAgentVault(project, note), { headers });
} catch (error) {
return failure(error);
}
}
export async function handlePostAgentVault(req: Request) {
const context = await getSessionContext();
if (!context) return failure(new Error("unauthorized"), 401);
if (context.role !== "owner") return failure(new Error("owner_required"), 403);
if (rateLimited(`agent-vault:sync:${context.session.device_id}`, 10, 60_000))
return failure(new Error("rate_limited"), 429);
try {
const body = await readSetupJson(req, 4096);
if (body.project !== undefined && typeof body.project !== "string")
throw new Error("project must be a string");
const result = await syncAgentVault(body.project as string | undefined);
void audit({
action: "fs.write",
actor: context.session.device_id,
target: result.state.root,
detail: "Refresh repository agent vault",
});
return json(result, { headers });
} catch (error) {
return failure(error);
}
}