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 { fit, pad } from "./mso-agent-editing.mjs";
export const CLEAR_LINE = "\x1b[2K";
export const CURSOR_UP = (n) => n > 0 ? `\x1b[${n}A` : "";
export const CURSOR_DOWN = (n) => n > 0 ? `\x1b[${n}B` : "";
export const CURSOR_RIGHT = (n) => n > 0 ? `\x1b[${n}C` : "";
export const CLEAR_SCREEN = "\x1b[2J\x1b[H";
export const PROMPT_ROWS = 3;
// Clamps composer rows:
// - At least PROMPT_ROWS (3) so clearing/erasing draft does not bounce the panel.
// - At most terminalRows - 4, which still leaves room for the chrome block and one transcript row.
// A quarter of the terminal would be 3 rows on a 12 row terminal, and a 6 line draft is exactly
// the case that overflows there, so the fraction was the wrong bound: it made the fix inert
// where it was needed.
export function clampPromptRows(rows, terminalRows) {
const termRows = Math.max(6, Number(terminalRows || 24));
const maxRows = Math.max(PROMPT_ROWS, termRows - 4);
return clamp(Number(rows) || 0, PROMPT_ROWS, maxRows);
}
const plain = (value) => String(value ?? "").replace(/\x1b\[[0-9;]*m/g, "");
export const chars = (value) => Array.from(String(value ?? ""));
export const width = (value) => chars(plain(value)).length;
export const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
export function reserveComposerRows(output, reservedRows, rows) {
const current = Math.max(0, Number(reservedRows) || 0);
const target = Math.max(0, Number(rows) || 0);
if (target === current) return current;
if (!output || typeof output.write !== "function") return target;
if (target > current) {
if (current) output.write(CURSOR_DOWN(current));
for (let i = current; i < target; i++) output.write("\r\n");
output.write(`${CURSOR_UP(target)}\r`);
return target;
}
// Shrink symmetrically. Moving down to the OLD extent and clearing upward releases the rows the
// frame no longer uses. Without this a closed completion menu left its rows reserved forever, so
// the prompt never moved back up and a gap sat above it.
if (current) output.write(CURSOR_DOWN(current));
for (let i = current; i > target; i--) output.write(`\r${CLEAR_LINE}${CURSOR_UP(1)}`);
output.write(`${CURSOR_UP(target)}\r`);
return target;
}
export function eraseComposerRows(output, reservedRows) {
output.write(`\r${CLEAR_LINE}`);
for (let i = 0; i < reservedRows; i++) output.write(`${CURSOR_DOWN(1)}\r${CLEAR_LINE}`);
if (reservedRows) output.write(`${CURSOR_UP(reservedRows)}\r`);
}
export function inputViewport(value, cursor, maxWidth) {
const row = chars(value), max = Math.max(1, maxWidth);
if (row.length <= max) return { display: row.join(""), cursor: clamp(cursor, 0, row.length) };
const interior = Math.max(1, max - 2);
let start = clamp(cursor - Math.floor(interior * 0.7), 0, Math.max(0, row.length - interior));
let end = Math.min(row.length, start + interior);
if (cursor > end) { end = cursor; start = Math.max(0, end - interior); }
const prefix = start > 0 ? "…" : "", suffix = end < row.length ? "…" : "";
return { display: `${prefix}${row.slice(start, end).join("")}${suffix}`, cursor: width(prefix) + clamp(cursor - start, 0, end - start) };
}
export function inputLayout(value, cursor, options = {}) {
const row = chars(value);
const columns = Math.max(20, Number(options.columns || 100));
const promptWidth = Math.max(0, Number(options.promptWidth || 0));
const terminalRows = Math.max(8, Number(options.rows || 24));
const lineWidth = Math.max(8, columns - promptWidth - 2);
const safeCursor = clamp(cursor, 0, row.length);
const totalLines = Math.max(1, Math.floor(row.length / lineWidth) + 1);
const absoluteCursorRow = Math.floor(safeCursor / lineWidth);
const cursorCol = safeCursor % lineWidth;
const requestedMaxRows = Number(options.maxRows || Math.floor(terminalRows * 0.32));
const maxRows = Math.max(2, Math.min(12, terminalRows - 4, requestedMaxRows || 2));
const visibleCount = Math.min(totalLines, maxRows);
const startLine = clamp(absoluteCursorRow - Math.floor(visibleCount / 2), 0, Math.max(0, totalLines - visibleCount));
const lines = Array.from({ length: visibleCount }, (_, offset) => {
const line = startLine + offset;
return row.slice(line * lineWidth, (line + 1) * lineWidth).join("");
});
return {
lines,
cursorRow: absoluteCursorRow - startLine,
cursorCol,
lineWidth,
totalLines,
startLine,
clippedTop: startLine > 0,
clippedBottom: startLine + visibleCount < totalLines,
};
}
export function verticalCursor(value, cursor, lineWidth, direction, preferredColumn = /** @type {number|null} */ (null)) {
const row = chars(value);
const width = Math.max(1, Number(lineWidth || 1));
const current = clamp(cursor, 0, row.length);
const currentRow = Math.floor(current / width);
const totalRows = Math.max(1, Math.floor(row.length / width) + 1);
const targetRow = currentRow + (direction < 0 ? -1 : 1);
const column = preferredColumn === null ? current % width : Math.max(0, Number(preferredColumn) || 0);
if (targetRow < 0 || targetRow >= totalRows) return { moved: false, cursor: current, column };
const start = targetRow * width;
const end = Math.min(row.length, start + width);
return { moved: true, cursor: Math.min(start + column, end), column };
}
export function completionWindow(items, selected, size = 8) {
const rows = Array.isArray(items) ? items : [];
if (!rows.length) return { start: 0, items: [] };
const count = Math.min(Math.max(1, size), rows.length), idx = clamp(selected, 0, rows.length - 1);
const start = Math.max(0, Math.min(idx - Math.floor(count / 2), rows.length - count));
return { start, items: rows.slice(start, start + count) };
}
export function menuLines(items, selected, columns, C, panelLabel = "commands & skills") {
const { start, items: visible } = completionWindow(items, selected, 8);
if (!visible.length) return [];
const panelWidth = Math.max(38, Math.min(100, Number(columns || 100) - 2));
const label = ` ${fit(panelLabel, Math.max(12, panelWidth - 8))} `;
const top = `╭─${label}${"─".repeat(Math.max(0, panelWidth - width(label) - 3))}╮`;
const nameWidth = Math.min(42, Math.max(12, ...visible.map((item) => width(item.label || item.text) + 1)));
const metaWidth = Math.max(0, panelWidth - nameWidth - 9);
const body = visible.map((item, offset) => {
const active = start + offset === selected;
const marker = active ? `${C.blue}${C.bold}›${C.reset}` : " ";
const stateColor = item.state === "queued" ? C.warn : ["invoking", "invoked"].includes(item.state) ? C.c : C.blue;
const stateMark = item.kind === "skill" ? `${stateColor}${item.state === "invoked" ? "✓" : item.state === "ready" ? "◇" : "◆"}${C.reset}` : " ";
const nameColor = item.kind === "skill" ? stateColor : active ? C.blue : "";
const displayText = item.label || item.text;
const name = nameColor ? `${nameColor}${active ? C.bold : ""}${pad(displayText, nameWidth)}${C.reset}` : pad(displayText, nameWidth);
const metaText = fit(item.meta || "", metaWidth), meta = metaWidth ? `${C.dim}${metaText}${C.reset}` : "";
return `│ ${marker} ${stateMark} ${name}${meta ? ` ${meta}` : ""}${" ".repeat(Math.max(0, metaWidth - width(metaText)))} │`;
});
const hint = " ↑↓ navigate · Enter/Tab select · Esc close ";
const bottomText = fit(hint, panelWidth - 3);
const bottom = `╰─${bottomText}${"─".repeat(Math.max(0, panelWidth - width(bottomText) - 3))}╯`;
return [`${C.blue}${top}${C.reset}`, ...body, `${C.blue}${bottom}${C.reset}`];
}
// Normalizes footer input (string, array of strings, or supplier function) into clean rows.
// Splits multi-line strings so writeFrame never receives embedded newlines that would cause scrollback.
export function footerLines(footer) {
const raw = typeof footer === "function" ? footer() : footer;
if (!raw) return [];
const list = Array.isArray(raw) ? raw : [raw];
return list.flatMap((row) => String(row ?? "").split(/\r?\n/)).filter(Boolean);
}