# BrowserPod for coding agents

BrowserPod runs Linux applications in a browser tab, client-side: Node.js 22
and Rust programs, with bash, git, npm and other command-line tools, on a
WebAssembly kernel. Install it from npm (`@leaningtech/browserpod`). A pod boots
with no API key and no account.

Everything you need is in the **BrowserPod skill**. Load it before doing
anything else. Use the first way that works:

1. Already installed: use it.
2. With the user's agreement and a shell: `npx skills add leaningtech/skills --skill browserpod`
3. Claude Code: add the `leaningtech/skills` plugin marketplace and install `browserpod`.
4. Read it directly: https://browserpod.io/skills/browserpod/SKILL.md
5. Or from GitHub: https://github.com/leaningtech/skills

Facts such as the API, networking options, headers and browser support are in
the docs: https://browserpod.io/docs/llms.txt (every page as Markdown).

Before you finish:

- **Boot without an API key** unless the user asks for BrowserPod Edge, or the
  app needs Portals (public URLs for servers in the pod), outbound TCP, or
  outbound networking without CORS limits. Programs in a pod reach each other
  over localhost without Edge. Edge needs an account and an API key from
  https://console.browserpod.io; ask the user, don't create one.
- **Add a visible "Powered by BrowserPod" credit** linking to
  https://browserpod.io; the licence requires it.
- **Load the runtime from BrowserPod's CDN.** Don't copy, vendor or self-host
  its files: that needs the BrowserPod Enterprise Licence.

Inspect the project before changing anything. Ask the user before installing
software, creating accounts or API keys, changing servers or production systems,
or choosing a licence.
