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 { readFileSync, readdirSync } from "node:fs";
import { join } from "node:path";
const TOOL_MODULE_NAME = /^tools-[A-Za-z0-9-]+\.ts$/;
const SCOPES = ["read", "write", "exec"];
const splitByScope = (rows) => {
const byScope = { read: [], write: [], exec: [] };
for (const [name, scope] of rows) byScope[scope].push(name);
for (const scope of SCOPES) byScope[scope].sort();
return byScope;
};
const countsFor = (byScope) => Object.fromEntries(SCOPES.map((scope) => [scope, byScope[scope].length]));
export function collectMcpCatalog(root) {
const read = (rel) => readFileSync(join(root, rel), "utf8");
const toolset = read("lib/mcp/toolset.ts");
const serverVersion = /MCP_SERVER_VERSION\s*=\s*"([^"]+)"/.exec(toolset)?.[1];
const version = /MCP_TOOLSET_VERSION\s*=\s*"([^"]+)"/.exec(toolset)?.[1];
const changedAt = /MCP_TOOLSET_CHANGED_AT\s*=\s*"([^"]+)"/.exec(toolset)?.[1];
if (!serverVersion || !version || !changedAt) throw new Error("could not parse MCP toolset constants");
const discoveredModules = readdirSync(join(root, "lib/mcp")).filter((name) => TOOL_MODULE_NAME.test(name)).sort();
const reachable = new Set();
const pending = ["tools.ts"];
while (pending.length) {
const name = pending.pop();
if (!name || reachable.has(name)) continue;
reachable.add(name);
const text = read(`lib/mcp/${name}`);
for (const match of text.matchAll(/from\s+["']\.\/(tools-[A-Za-z0-9-]+)["']/g)) {
const child = `${match[1]}.ts`;
if (!reachable.has(child)) pending.push(child);
}
}
const orphanModules = discoveredModules.filter((name) => !reachable.has(name));
const missingModules = [...reachable].filter((name) => name !== "tools.ts" && !discoveredModules.includes(name));
const all = new Map();
for (const file of [...reachable].sort().map((name) => `lib/mcp/${name}`)) {
const text = read(file);
for (const match of text.matchAll(/name:\s*"([^"]+)"[\s\S]*?scope:\s*"(read|write|exec)"/g)) all.set(match[1], match[2]);
}
const toolContract = read("lib/mcp/tool-contract.ts");
const appOnlyBlock = /CHATGPT_APP_ONLY_TOOL_NAMES\s*=\s*new Set\(\[([\s\S]*?)\]\s*as const\)/.exec(toolContract)?.[1] ?? "";
const appOnlyNames = [...appOnlyBlock.matchAll(/"([^"]+)"/g)].map((match) => match[1]);
const appOnlySet = new Set(appOnlyNames);
const appOnlyMissing = appOnlyNames.filter((name) => !all.has(name));
const appOnly = appOnlyNames.filter((name) => all.has(name)).sort();
const model = [...all].filter(([name]) => !appOnlySet.has(name));
const byScope = splitByScope(model);
// ChatGPT receives the complete MSO-owned generic model/operator catalog.
// The two compatibility bridges remain app-only and project-owned MCP names
// remain dynamic behind project_mcp_tools/project_mcp_call.
const chatgptNames = [...all.keys()];
const profileMissing = [];
const chatgptAppOnly = [...appOnly];
const chatgptModel = [...model];
const chatgptByScope = splitByScope(chatgptModel);
return {
serverVersion, version, changedAt, all, model, byScope, appOnly,
transportCount: all.size,
modelCount: model.length,
counts: countsFor(byScope),
chatgpt: {
names: chatgptNames,
model: chatgptModel,
byScope: chatgptByScope,
appOnly: chatgptAppOnly,
transportCount: chatgptNames.filter((name) => all.has(name)).length,
modelCount: chatgptModel.length,
counts: countsFor(chatgptByScope),
},
orphanModules, missingModules, profileMissing, appOnlyMissing,
};
}
export function renderMcpCatalogMarkdown(catalog) {
const list = (rows) => rows.map((name) => `- \`${name}\``).join("\n") || "- none";
const c = catalog.chatgpt;
return `# Generated MCP catalog
> **Generated file — do not edit manually.** Source of truth: \`lib/mcp/tools.ts\`, its registered \`tools-*\` modules, \`lib/mcp/toolset.ts\`, and the ChatGPT app-only exclusions in \`lib/mcp/tool-contract.ts\`. Regenerate with \`node scripts/gen-mcp-catalog.mjs\`. The live deployed authority remains \`GET /mcp\`.
## Full MSO catalog
<!-- mcp-toolset: server=${catalog.serverVersion} version=${catalog.version} tools=${catalog.modelCount} read=${catalog.counts.read} write=${catalog.counts.write} exec=${catalog.counts.exec} -->
| Fact | Current source value |
|---|---:|
| MCP server | \`${catalog.serverVersion}\` |
| Toolset | \`${catalog.version}\` |
| Toolset changed at | \`${catalog.changedAt}\` |
| Transport tools | **${catalog.transportCount}** |
| Model/operator tools | **${catalog.modelCount}** |
| Read | **${catalog.counts.read}** |
| Write | **${catalog.counts.write}** |
| Exec | **${catalog.counts.exec}** |
| App-only bridges | **${catalog.appOnly.length}** |
### Read (${catalog.counts.read})
${list(catalog.byScope.read)}
### Write (${catalog.counts.write})
${list(catalog.byScope.write)}
### Exec (${catalog.counts.exec})
${list(catalog.byScope.exec)}
### App-only bridges (${catalog.appOnly.length})
${list(catalog.appOnly)}
## ChatGPT model profile
<!-- mcp-chatgpt-profile: server=${catalog.serverVersion} version=${catalog.version} tools=${c.modelCount} read=${c.counts.read} write=${c.counts.write} exec=${c.counts.exec} app-only=${c.appOnly.length} total=${c.transportCount} -->
The ChatGPT profile automatically projects the complete MSO-owned generic model/operator catalog. OAuth scope is still enforced independently; app-only compatibility bridges stay app-only, and project-owned MCP tool names remain dynamic data behind the generic project bridge.
| Fact | Current source value |
|---|---:|
| ChatGPT transport tools | **${c.transportCount}** |
| ChatGPT model/operator tools | **${c.modelCount}** |
| Read | **${c.counts.read}** |
| Write | **${c.counts.write}** |
| Exec | **${c.counts.exec}** |
| App-only bridges | **${c.appOnly.length}** |
### ChatGPT read (${c.counts.read})
${list(c.byScope.read)}
### ChatGPT write (${c.counts.write})
${list(c.byScope.write)}
### ChatGPT exec (${c.counts.exec})
${list(c.byScope.exec)}
### ChatGPT app-only bridges (${c.appOnly.length})
${list(c.appOnly)}
`;
}