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 fs from "node:fs";import readline from "node:readline";import tty from "node:tty";
import { buildFrame, paint } from "./renderer.mjs";import { columns, context } from "./model.mjs";
function list(config){return buildFrame(config,{cols:config.__cols||120,rows:config.__rows||30}).items;}
export function shortcutEvent(key,config){const k=String(key||"").toLowerCase(),ctx=context(config.stack);if(/[1-4]/.test(k))return{type:"section",id:{1:"connections",2:"users",3:"catalog",4:"transfer"}[k]};if(k==="?")return{type:"shortcut",id:"help"};if(k==="e")return{type:"shortcut",id:"export"};if(k==="i")return{type:"shortcut",id:"import"};if(k==="n"&&ctx.user&&ctx.provider)return{type:"shortcut",id:"new"};if(k==="v"&&ctx.connection)return{type:"shortcut",id:"verify"};if(k==="r"&&ctx.connection)return{type:"shortcut",id:"route"};if(k==="s"&&ctx.connection)return{type:"shortcut",id:"setup"};if(k==="d"&&(ctx.connection||ctx.user))return{type:"shortcut",id:"default"};return null;}
export function run(configPath){const config=JSON.parse(fs.readFileSync(configPath,"utf8")),fd=fs.openSync("/dev/tty",fs.constants.O_RDWR),input=new tty.ReadStream(fd),output=new tty.WriteStream(fd);readline.emitKeypressEvents(input);let query=String(config.query||""),cursor=0,filterMode=Boolean(config.filterMode),activity=config.activity||[];const initial=String(config.initialId||"");const refresh=()=>{const f=buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});if(initial&&cursor===0){const idx=f.items.findIndex((x)=>x.id===initial);if(idx>0){cursor=idx;return buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});}}return f;};let first=true;const render=()=>{const f=refresh();if(first&&initial){const idx=f.items.findIndex((x)=>x.id===initial);if(idx>=0)cursor=idx;first=false;}const final=buildFrame({...config,query,cursor,filterMode,activity},{cols:output.columns,rows:output.rows});paint(output,final.lines);return final;};const finish=(event)=>{const f=render();input.off("keypress",onKey);if(typeof input.setRawMode==="function")input.setRawMode(false);input.pause();process.stdout.write(JSON.stringify({...event,selectedId:f.items[f.cursor]?.id||null,query,filterMode}),()=>process.exit(0));};const activate=()=>{const f=render(),it=f.items[f.cursor];if(it)finish({type:it.kind==="branch"?"open":"select",id:it.id});};const onKey=(str,key={})=>{activity=[];if(key.ctrl&&(key.name==="c"||key.name==="d"))return finish({type:"quit"});if(key.name==="up"){const n=render().items.length;cursor=n?(cursor-1+n)%n:0;}else if(key.name==="down"){const n=render().items.length;cursor=n?(cursor+1)%n:0;}else if(key.name==="home")cursor=0;else if(key.name==="end")cursor=Math.max(0,render().items.length-1);else if(key.name==="left")return finish({type:config.stack.length?"back":"noop"});else if(key.name==="right"||key.name==="return"||key.name==="enter"||key.name==="tab")return activate();else if(key.name==="escape"){if(filterMode||query){filterMode=false;query="";cursor=0;}else return finish({type:config.stack.length?"back":"noop"});}else if(key.name==="backspace"&&filterMode){query=[...query].slice(0,-1).join("");cursor=0;}else if(key.ctrl&&key.name==="u"&&filterMode){query="";cursor=0;}else if(str==="/"&&!filterMode){filterMode=true;query="";cursor=0;}else if(filterMode&&str&&!key.ctrl&&!key.meta&&!/[\x00-\x1f\x7f]/.test(str)){query+=str;cursor=0;}else if(!filterMode&&str){const ev=shortcutEvent(str,config);if(ev)return finish(ev);}render();};input.on("keypress",onKey);input.resume();input.setRawMode(true);render();}
if(import.meta.url===`file://${process.argv[1]}`)run(process.argv[2]);