typebulb 0.9.4 → 0.9.6

package/README.md

@@ -43,7 +43,9 @@ npm install -g typebulb
 
 ```
 typebulb [file.bulb.md]        Run a bulb (defaults to .bulb.md in cwd)
+typebulb claude                Launch claude.bulb, the built-in session viewer
 typebulb check [file.bulb.md]  Type-check a bulb without running it
+typebulb predict [file]        Report the capability a bulb probably needs, without running it
 typebulb logs [file|pid]       Print a running bulb's captured console (-f follow, -n N tail)
 typebulb stop [file|pid]       Stop a running bulb (no arg: list running servers)
 typebulb trust [file]          Remember a bulb as trusted (no arg: list trusted bulbs)
@@ -51,6 +53,7 @@ typebulb untrust <file>        Forget a bulb's trust (back to sandboxed)
 typebulb --no-watch <file>     Disable hot reload
 typebulb --port 3333 <file>    Custom port
 typebulb --no-open <file>      Don't auto-open browser
+typebulb --mode <name> <file>  Also load .env.<name> on top of .env / .env.local
 typebulb --trust <file>        Grant filesystem + AI + server.ts for this run (default: sandboxed)
 typebulb --no-trust <file>     Force sandboxed even if the bulb is remembered-trusted
 typebulb --server <file>       Run server.ts only, no web server (needs --trust)
@@ -63,7 +66,7 @@ typebulb --version             Show version
 
 - **Server-side code** — Add a `**server.ts**` section; exported functions become callable from the browser via `tb.server.<name>()` (e.g., `export async function query(...)` → `await tb.server.query(...)`). Requires `--trust`.
 - **CLI logging** — `tb.server.log(...)` prints to the CLI's stdout
-- **Env files** — `.env` and `.env.local` auto-loaded from cwd
+- **Env files** — `.env` / `.env.local` load from cwd, `.env.local` overriding `.env` (an exported shell var wins over both). `--mode <name>` adds `.env.<name>` to switch environments (local/staging/prod); a startup line reports which keys loaded from where.
 - **Server mode** — `--server` runs only the `**server.ts**` section in Node, skipping the web server. Bulbs with only `**server.ts**` (no `**code.tsx**`) use this mode automatically.
 - **Type-check without running** — `typebulb check <file>` runs `tsc --noEmit` against the bulb and exits non-zero on errors. Useful for AI editors / CI.
 - **Filesystem access** — `tb.fs.read()` (UTF-8 text), `tb.fs.readBytes()` (raw `Uint8Array`), and `tb.fs.write()` (text or bytes) for local files. Requires `--trust`.
@@ -73,6 +76,7 @@ typebulb --version             Show version
 - **Local caching** — Resolver metadata and CDN package bytes are cached under `~/.typebulb/cache/`, so repeat runs don't re-hit the network and warm runs work offline.
 - **AI calls** — `tb.ai()` for general-purpose AI (chatbots, agents, experiments). `tb.models()` lists available models. Set API keys in `.env` (see below). Requires `--trust`.
 - **Sandboxed by default** — A plain `npx typebulb my-app.bulb.md` runs with no filesystem or `server.ts` (like typebulb.com); `--trust` grants those for a run. Trust is **remembered**: `typebulb trust <file>` elevates a bulb once so later plain runs are trusted, `untrust` revokes it, and `--no-trust` forces sandboxed for a single run.
+- **Predict trust** — `typebulb predict <file>` reports the capability a bulb will likely need (fs / AI / `server.ts`) without running it, so you can decide on `--trust` up front rather than after a mid-run permission failure.
 
 ## AI Setup