chamba 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # chamba
 
-A browser workspace paired to your terminal coding agent over one shared conversation.
+A browser workspace beside your terminal coding agent - a rich parallel interface to the terminal chat.
 
 ## Quick start
 
@@ -10,11 +10,10 @@ Install the skill for your agent:
 npx chamba@latest skill install
 ```
 
-Then, in your agent, run `/chamba` (or ask it to "open chamba"). It opens a browser workspace where you read rendered markdown, paste screenshots the agent can read, and point at UI - all in the same thread as the terminal.
+Then, in your agent, run `/chamba` (or ask it to "open chamba").
+It opens a browser workspace where you read rendered markdown, paste screenshots the agent can read, point at UI in the app tab, and view rich HTML pages the agent renders in the Illustration tab.
 
-When the session opens, the browser asks how you will use it.
-Pick **everyday** for open conversation beside your app, or **spec** for a structured interview that builds a spec package with Draft, Mock, and Diagram surfaces.
-The choice sets up that same session; the agent then drives it accordingly.
+The browser is a second conversation beside the terminal: a background `chamba poll` keeps the agent listening for browser input while it stays available in the terminal, and each channel is answered where it was asked.
 
 Add `--global` to install the skill for every project (`~/.claude/skills`).
 
@@ -28,7 +27,7 @@ Add `--global` to install the skill for every project (`~/.claude/skills`).
 | Path | Covers | Run by |
 | --- | --- | --- |
 | `packages/*/src/**/*.test.ts` | Unit tests colocated with each package (`shared`, `server`, `cli`, `inject`): pure schema and logic. | `pnpm test` (Vitest `unit` project, parallel). |
-| `tests/integration/` | Integration: real server and CLI processes over real ports and the WebSocket transport (roundtrip, durability, annotations, attachments, issues, spec sessions, init, lifecycle). Shared helpers live in `tests/support/`. | `pnpm test` (Vitest `integration` project, sequential forks with long timeouts, since parallel port binding would flake). |
+| `tests/integration/` | Integration: real server and CLI processes over real ports and the WebSocket transport (roundtrip, durability, annotations, attachments, issues, pages, references, binding, init, lifecycle). Shared helpers live in `tests/support/`. | `pnpm test` (Vitest `integration` project, sequential forks with long timeouts, since parallel port binding would flake). |
 | `tests/e2e/` | End-to-end: a real browser drives the production web build against a real server and CLI, proving the human and agent exchange renders live. | `pnpm test:e2e` (Playwright, serial; `pretest:e2e` installs the browser first). |
 | `tests/fixtures/` | Sample apps for the "Your app" surface: a Vite + React app on port 4001 and a Next.js app on port 4002. The e2e suite drives the React app as a cross-origin annotation target; both are runnable by hand for manual exploration. | `pnpm fixture:react`, `pnpm fixture:next` (see `tests/fixtures/README.md`). |
 
@@ -61,7 +60,7 @@ Each runs from the repo root; add `-w` (`pnpm -w dev:next`) to run it from any s
 - `pnpm -s chamba open` - inside the session, opens chamba and prints its URL.
 
 Confirm the workspace publishes chamba's port with `CHAMBA_HOST=0.0.0.0` and `CHAMBA_PORT=4319`; the fixture's inject script targets `:4319`.
-Then open the printed chamba URL, point the "Your app" tab at `:4002`, and do real work: paste a screenshot, annotate, run a spec session.
+Then open the printed chamba URL, point the "Your app" tab at `:4002`, and do real work: paste a screenshot, annotate, ask the agent to show an illustration page.
 
 ---