Dhravya/burrow - 仓库详情

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它是罕见的纯客户端开发环境，内置基于 WebGPU 的本地 AI 编程助手；使用 Bun 的真实转译器（通过 WASM）；在 MIT 许可下提供了 WebContainers 的替代方案。

适合谁使用

希望不用本地安装即可进行原型开发的 Bun 和 JavaScript 开发者
在浏览器中教授全栈开发的教育工作者
在沙盒中实验 AI 辅助编码的爱好者
需要便携、可离线使用的开发环境的前端开发者

典型使用场景

从任何设备快速搭建 Bun HTTP 服务器或 Hono 应用
在浏览器中学习和实验 Bun、TypeScript、git 和 npm
利用 AI 助手自动编辑文件并运行命令完成小型任务
创建一个跨会话持久化的实时编码工作区（通过 IndexedDB）

项目优势

完全在客户端运行，没有远程后端，保护隐私并支持离线使用
使用 Bun 真正的 Rust 基于转译器（WASM），避免重新实现的偏差
内置基于 WebGPU 的本地 AI 编码助手，利用用户 GPU 运行
完全开源（MIT 许可），允许自定义和自托管

使用前须知

不支持原始 TCP，因此 PostgreSQL/Redis 客户端需要单独的中继
尚不支持 git 推送/拉取操作
仅支持使用 fetch 处理函数的 Bun.serve()，不支持 WebSocket 或路由
早期项目，与 WebContainers 相比兼容性较小

README 快速开始

A whole dev machine in a browser tab. Real Bun, real git, a real shell, a live server preview, and a local AI coding agent — all running on your own machine, inside the page. No backend, no remote sandbox, nothing leaves the tab.

An open-source, Bun-native alternative to WebContainers.

Try it live → burrow.page

Open it, type bun run index.ts, watch a server come up. Then ask the agent panel to "create a Bun HTTP server in src/server.ts and run it" — a model on your GPU edits the files and runs the commands, in the tab.

The trick

You can't compile Bun to WebAssembly and run it in a browser — Bun is Zig on JavaScriptCore, and JSC-in-WASM isn't practical. So Burrow does what WebContainers does: run JavaScript on the browser's own engine, and virtualize everything around it. The pieces that make that feel like a real machine:

bun.wasm — Bun's actual Rust transpiler, compiled to WebAssembly and driven through a hand-written WASI shim. Your .ts/.tsx/.jsx is transpiled with genuine Bun semantics, not a reimplementation.
A virtual filesystem that everything shares — the editor, the shell, git, the package manager, and the runtime all read and write the same in-memory tree, which is snapshotted to IndexedDB so your workspace survives a reload.
Web Workers as processes — each bun run boots a dedicated module worker from a generated bootstrap; the code executes on the host engine.
A service worker as the network — Bun.serve() inside a worker is bridged back out to a real, fetchable URL in the page, so you can open your server in an iframe (or a new tab) and hit its routes.

Everything is client-side. The only network calls Burrow itself makes are a CORS proxy for git clone and the npm registry for bun install — both are plain same-origin passthroughs you can see in server.ts.

What you get


Terminal	Interactive bash (via just-bash) — history, tab-completion, `Ctrl+C`/`A`/`E`/`U`/`W`/`L`, pipes, globs, `cd`/`export` that persist.
Editor	CodeMirror 6, file tree with full create/rename/delete, per-file debounced autosave, a live git diff panel.
Runtime	`bun run file.ts` — real transpile → module graph → worker execution, with streamed stdout/console.
Server preview	`Bun.

项目描述

a whole dev machine in a browser tab - bun.wasm, shell, git, and local AI. phones home to nobody.

burrow