wild-workspace — Claude Code Web

A Replit/Lovable-style chat-first browser UI that wraps the AI agent already installed on your machine (Claude Code by default; Gemini / GLM / Codex if present).

v0.1.1 — chat-first workspace + bmo-sync daemon (npm) + per-user proxy (b-ii) live. Implements PRD §5.5 (workspace-platform-prd.md v0.10).

Quick start

# recommended — global install from npm
npm i -g @venturewild/workspace
wild-workspace

A global install pulls the matching bmo-sync daemon binary automatically for win32-x64 / darwin-x64 / darwin-arm64 / linux-x64 (shipped as optionalDependencies).

To build from source instead (dev path):

# install dependencies & web build
npm install
npm run build

# launch
node server/src/index.mjs
# or after `npm install -g .`
wild-workspace

Opens http://localhost:5173 in your default browser.

What's in here

wild-workspace/
├── server/                # Node.js Hono server + WebSocket bridge
│   ├── bin/
│   │   └── wild-workspace.mjs   # CLI entry (the `bin` field)
│   └── src/
│       ├── index.mjs            # server bootstrap
│       ├── config.mjs           # config + role definitions
│       ├── agent.mjs            # claude / gemini / glm / codex subprocess wrapper
│       ├── account.mjs          # login / account + slug claim
│       ├── share.mjs            # JWT share-token mint + verify
│       ├── inbox.mjs            # .wild/inbox.md watcher
│       ├── fs.mjs               # workspace file tree (collapsed by default)
│       ├── activity.mjs         # AI activity event bus
│       ├── preview.mjs          # dev-server port detection
│       ├── sync.mjs             # bmo-sync wiring
│       ├── daemon-bin.mjs       # resolves the platform daemon binary
│       └── routes/              # REST + WS endpoints
├── web/                   # React + Vite frontend
│   └── src/
│       ├── App.jsx              # role-flagged React tree (partner / viewer / client)
│       ├── components/          # Chat, Preview, FileTree, Onboarding, ShareDialog…
│       └── state/               # session + chat stores
├── vw-proxy/              # Cloudflare Worker — public *.venturewild.llc front door
├── landing/               # marketing / landing page (Cloudflare Pages)
└── docs/                  # design notes (incl. b-ii-proxy-plan.md / -design.md)

The three roles (AR-19)

| Role | URL pattern | What they see | |---|---|---| | partner | http://localhost:5173 | Chat + preview + file tree + terminal toggle + inbox + share + deploy | | partner (published) | https://<user>.venturewild.llc | Your workspace, live on your claimed per-user subdomain (e.g. tuananh.venturewild.llc) | | viewer | https://<user>.venturewild.llc/<wsid>?t=<token> | Chat history (read-only) + preview + presence + activity stream | | client | https://workspace.<client>.com | Chat + preview + "request changes" only |

Same React tree, role-gated visibility (AR-19).

AR-17: wrap don't embed

We don't ship an AI agent. server/src/agent.mjs spawns claude (or gemini / glm / codex if installed) as a subprocess and pipes stdout/stderr through WebSocket to the chat UI. The wrapped agent's modes mirror automatically (AR-18). (The one native binary we do bundle is the bmo-sync daemon — see below.)

bmo-sync daemon + per-user URLs

The workspace bundles the bmo-sync daemon (run as a subprocess) which links your local workspace to a per-user subdomain https://<user>.venturewild.llc:

browser → vw-proxy (Cloudflare Worker on *.venturewild.llc)
        → bmo-sync (Fly, bmo-sync.fly.dev) → your daemon → local workspace server

The Worker reads the Host header, resolves the slug via bmo-sync, and forwards to the bmo-sync Fly origin, which proxies to your most-recently-connected daemon. A claimed slug serves your live workspace (e.g. tuananh.venturewild.llc → 200); an unclaimed slug 302-redirects to the landing page (e.g. apple.venturewild.llc).

The daemon ships via npm optionalDependencies (@venturewild/workspace-daemon-*@0.1.0 for win32-x64 / darwin-x64 / darwin-arm64 / linux-x64), resolved at launch by server/src/daemon-bin.mjs. Shipped + verified live as of 2026-05-30; see docs/b-ii-proxy-plan.md, docs/b-ii-proxy-design.md, and docs/ECOSYSTEM.md.

Rich chat rendering

The chat is the product (AR-16), so it renders like one:

• Markdown — agent replies render as GitHub-flavored markdown (Markdown.jsx).
• Syntax-highlighted code — fenced code blocks via prism-react-renderer, with a copy button.
• Tool cards — each tool call (Read, Edit, Bash, …) renders as a compact card with a running/done/error status (ToolCard.jsx).
• Inline diffs — Edit / Write / MultiEdit show a red/green line diff right in the chat (DiffView.jsx).
• Live streaming — text streams token-by-token from the rebuilt agent.mjs stream-json parser, with a per-turn cost + token footer.

License

MIT — VentureWild.