0 5 0/feat/second readme update#11
Open
Liamoscarmccaffrey wants to merge 3 commits intomainfrom
Open
Conversation
alexp-sssup
reviewed
May 7, 2026
| <link rel="icon" href={favicon} /> | ||
| <meta property="og:title" content="BrowserCode" /> | ||
| <meta property="og:description" content="Run AI coding CLIs in-browser." /> | ||
| <meta name="description" content={pageDescription} /> |
Member
There was a problem hiding this comment.
This is redundant. There is already a description tag coming from elsewhere. In the page there will be two tags which might confuse crawlers
alexp-sssup
reviewed
May 7, 2026
| <br /> | ||
|
|
||
| <h2 id="about">What is BrowserCode?</h2> | ||
| # Build web apps that embed AI coding CLIs |
Member
There was a problem hiding this comment.
This is not correct and confusing
| # Build web apps that embed AI coding CLIs | ||
|
|
||
| BrowserCode is a browser runtime for AI coding CLIs. BrowserCode is a working example of [BrowserPod](https://browserpod.io/), it includes: | ||
| BrowserCode is an open source project built on [BrowserPod](https://browserpod.io/), a serverless runtime with a POSIX filesystem, `bash`, `git`, `npm`, and live previews, all running client-side via WebAssembly. |
Member
There was a problem hiding this comment.
'Serverless' means "run on edge server". Does not mean run in a browser.
|
|
||
| <h2 id="breaking-browsercode">Breaking BrowserCode</h2> | ||
| This is BrowserCode beta. Don't be kind to it. Stretch it, bend it, find out what breaks. Here are a few walls you might hit: | ||
| BrowserCode is a runtime for AI coding CLIs. Using [BrowserPod](https://browserpod.io/), the POSIX filesystem, the dev server, and the network proxy all run **inside the user's browser tab** via WebAssembly. It boots instantly. |
Member
There was a problem hiding this comment.
I would not agree with this. It's an demo or integration of BrowserPod to run coding CLIs maybe?
Member
There was a problem hiding this comment.
The network proxy also by definition does not run in the browser
| | [`/codex`](https://browsercode.io/codex) | Codex *(coming soon)* | | ||
| | [`/opencode`](https://browsercode.io/opencode) | OpenCode *(coming soon)* | | ||
|
|
||
| Depending on your auth method, you may be asked to copy a code from a separate tab. After that, prompt the agent like you would on your laptop — except the filesystem it edits, the `npm install` it runs, and the dev server it spins up are all living in the same tab. |
| │ └──────────────┘ │ BrowserPod portal ──── public URL ──┼──┐ | ||
| │ │ │ │ | ||
| │ ┌──────────────┐ └─────────────────────────────────────────┘ │ | ||
| │ │ Portal pane │◀──────────── iframe ──────────────────────────── │ |
Member
There was a problem hiding this comment.
Extend the art on 3-4 cols to be able to see the iframe arrow separate from the browser tab box
| | **Real Node.js, in the browser** | Node 22 compiled to Wasm. Run `node`, `npm install`, `npm run build` against an actual POSIX filesystem — no shims, no fake VFS. | | ||
| | **POSIX-like filesystem** | Pods are ephemeral, but files can persist via OPFS / IndexedDB. The agent's project state is yours, scoped to the tab. | | ||
| | **Instant previews via portal URLs** | Any port the agent opens gets a public preview URL through BrowserPod's portal. | | ||
| | **Cross-origin isolated** | `COOP`/`COEP`/`CORP` headers configured for both Vite dev and Cloudflare prod (see [_headers](_headers) and [vite.config.ts](vite.config.ts)). Required for `SharedArrayBuffer` and Wasm threads. | |
Member
There was a problem hiding this comment.
This is not a feature, it's a requirement
| export const cliConfigs: Record<string, CLIConfig> = { | ||
| // ... | ||
| mytool: { | ||
| userImage: 'wss://disks.browserpod.io/mytool_YYYYMMDD.ext2', |
Member
There was a problem hiding this comment.
Users cannot load images there. We should either remove this section or document how to use images hosted locally or on user servers.
|
|
||
| This is BrowserCode's second beta. Don't be kind to it. Here are the walls you'll hit: | ||
|
|
||
| - **The agent may ignore its primer on the first turn.** The `CLAUDE.md` / `GEMINI.md` shipped into the Pod tells the model it's running on Wasm, but it can default to its usual behavior before consulting the file. Re-prompt or remind it. |
Member
There was a problem hiding this comment.
I don't think this is true at all
Deploying browsercode with
|
| Latest commit: |
f3ad8b8
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://89fd24b7.browsercode.pages.dev |
| Branch Preview URL: | https://0-5-0-feat-second-readme-upd.browsercode.pages.dev |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.