Crundi – a self-hosted remote workbench you reach from anywhere

Crundi, a self-hosted remote workbench, launches as an open-source tool that exposes project terminals, files, git, task boards, and scheduling through a mobile-friendly web UI via a secure tunnel. The tool supports pluggable agents like Claude Code and Telegram-based login, running on Node.js with optional Cloudflare tunneling. It targets developers seeking a private, accessible development environment from anywhere.

A self-hosted remote workbench for your projects. Crundi runs on your machine and exposes your projects — agent terminals, files, git, a task board, scheduling and more — through a mobile-friendly web UI reachable from anywhere over a secure tunnel. Your phone becomes a window into your dev box at home. Agents and the access channel are pluggable. Today the available agent is Claude Code interactive CLI — your flat-rate subscription, not the metered Agent SDK , and remote login + notifications run through Telegram ; more can be added the same way. Workbench — multiple agent terminals per project, side by side, plus embeddable Files / Git / Kanban / Mindmap panels. Drag a file, git change, kanban card/subtask, or mindmap node onto a terminal to insert a reference desktop + mobile . Schedule — on a one-time or recurring schedule, run an agent with model / effort / mode / session + prompt , a CLI command, or start/stop a service — gated by conditions 5h/weekly usage %, open-terminal count, kanban status . Kanban & Mindmap — per-project task board and a global brainstorming mindmap that can link to tasks. Files — browser with gitignore-aware search, browse above the project root, upload/download/delete. Git — status, side-by-side diff, stage/unstage, commit, push/pull. Services — register and run background services PM2-style per project, with live status. Tools — headless browser automation, screenshots/window capture, a secrets vault PIN-gated , and an agent usage meter. MCP server — exposes project-scoped tools kanban, mindmap, schedule, services, terminals, browser, screenshots, secrets, notifications so agents can drive Crundi. Desktop app Electron + mobile-friendly web UI. Node.js 18+- The agent's CLI on your PATH — currently Claude Code claude , installed and authenticated - A login/notification channel — currently a Telegram bot token from @BotFather https://t.me/BotFather Optional a Cloudflare account for a persistent tunnel domain — otherwise a free random quick tunnel is used Windows recommended : download Crundi.Setup.<version .exe from the latest release /TheRealFaruhaan/crundi/releases/latest and run it. The installer is self-signed TheRealFaruhaan . From source: git clone https://github.com/TheRealFaruhaan/crundi.git cd crundi npm install npm start desktop app Electron or npm run start:headless server only no Electron window On first launch Crundi shows a step-by-step wizard: Create a bot with @BotFather and paste the token current login channel . Your Telegram username — only this user can access Crundi. Projects — point at a parent folder each subfolder = a project , or add projects individually. Cloudflare tunnel optional — paste a named-tunnel token + URL for a fixed domain, or skip for a random quick tunnel. Do not install Cloudflare's connector; Crundi bundles and runs cloudflared itself. Enable login — set your bot's login domain in @BotFather /setdomain to your public URL so the login button works. Config is stored in your OS app-data dir; you can also use a .env see .env.example : | Variable | Required | Description | |---|---|---| TELEGRAM BOT TOKEN | yes | Bot token from @BotFather login validation + notifications | ALLOWED USERNAME | yes | Your Telegram username, no @ — the only allowed user | PROJECTS DIR | | Parent folder of projects single-folder mode ; leave empty for multi-folder mode | WEB PORT | no | Web UI port 0 = auto-assign | CLOUDFLARE TUNNEL TOKEN | no | Named-tunnel token for a persistent domain | CLOUDFLARE TUNNEL URL | no | The tunnel's public URL | DATA DIR | no | Override the data directory | npm run build electron-builder --win → dist/ Code signing uses a .pfx supplied via the CSC LINK / CSC KEY PASSWORD environment variables not committed . Crundi is a single-user remote-control tool . Whoever authenticates gets, on the host machine: - a full interactive shell agent terminals + arbitrary commands , - file read/write — and read/download can go above a project's root, - start/stop of registered services, - screen capture and basic GUI automation. That power is the point — but treat it accordingly: run it only for yourself , keep your tunnel URL private, set the login domain, and never share your bot token. Anyone who reaches the URL and passes auth controls the machine. Bug reports and questions are welcome — open an issue /TheRealFaruhaan/crundi/issues . External code contributions pull requests aren't being accepted right now, and main is protected; fork freely under MIT. For security issues see SECURITY.md /TheRealFaruhaan/crundi/blob/main/SECURITY.md ; details in CONTRIBUTING.md /TheRealFaruhaan/crundi/blob/main/CONTRIBUTING.md . MIT /TheRealFaruhaan/crundi/blob/main/LICENSE © 2026 Hussain Faruhaan.