docs: update local dev workflow, remove pnpm link references

Replace misleading `pnpm link --global` instructions with `tsx cli.ts
serve` (from source) and `node dist/cli.mjs serve` (from build).
Add Playwright to checks section.

Author: connorads

AGENTS.md

@@ -23,12 +23,28 @@ Pure TypeScript + DOM API — no framework. Transpiles to JS via tsdown for npm
 ```bash
 git config core.hooksPath .hk-hooks  # Run once after clone
 pnpm test              # Run all tests
+pnpm run test:pw       # Playwright e2e tests (chromium + webkit)
 pnpm run check         # Biome lint + format check
 pnpm run check:fix     # Auto-fix lint + format
 pnpm run build         # Build dist/index.html (dev-time, uses tsx)
 pnpm run build:dist    # Transpile for publishing (tsdown)
 ```
 
+## Local Development
+
+From source (bundles overlay on the fly, no build step):
+
+```bash
+tsx cli.ts serve                                # localhost:7681, default tmux session
+tsx cli.ts serve --port 8080 -- bash --norc     # custom port, bash instead of tmux
+```
+
+From a local build:
+
+```bash
+pnpm run build:dist && node dist/cli.mjs serve
+```
+
 ## Conventional Commits
 
 Commits must follow [Conventional Commits](https://www.conventionalcommits.org/) format, enforced by hk commit-msg hook.
@@ -93,7 +109,7 @@ Commits must follow [Conventional Commits](https://www.conventionalcommits.org/)
   - `npx semantic-release --dry-run` for local verification
   - Release triggers: `feat:` → minor, `fix:` → patch, `BREAKING CHANGE` → major
   - No release: `chore:`, `docs:`, `refactor:`, `test:`, `ci:`
-- `pnpm link --global` for local development (CLI available globally)
+- See **Local Development** above for running from source
 
 ## Conventions
 

README.md

@@ -53,7 +53,7 @@ npm install -g remobi
 remobi serve
 ```
 
-For local development, use `pnpm link --global` from the repo root instead of `npm install -g remobi`.
+For local development, see the [Development](#development) section below.
 
 Open `http://localhost:7681` on the same machine to verify it works. For phone access, put a trusted proxy/tunnel in front of it, for example [Tailscale Serve](docs/guides/tailscale-serve.md).
 
@@ -281,21 +281,27 @@ git config core.hooksPath .hk-hooks   # enable commit hooks (conventional commit
 
 ### Running locally
 
+From source (bundles overlay on the fly via esbuild — no build step needed):
+
 ```bash
-pnpm run build:dist          # transpile TS → JS (tsdown) — must re-run after source changes
-node dist/cli.mjs serve      # runs the locally-built version on http://localhost:7681
+tsx cli.ts serve              # localhost:7681, default tmux session
 ```
 
-Or use `pnpm link --global` to make the `remobi` CLI available globally, then run `remobi serve`.
+Or build first, then run from dist/:
+
+```bash
+pnpm run build:dist          # transpile TS → JS + bundle overlay
+node dist/cli.mjs serve      # run locally-built version on localhost:7681
+```
 
-There is no watch mode — re-run `pnpm run build:dist` after each code change.
+No watch mode — re-run the build or use `tsx` for automatic source bundling.
 
 ### Checks
 
 ```bash
-pnpm test            # vitest
+pnpm test            # vitest (unit + integration)
+pnpm run test:pw     # playwright e2e (needs: pnpm exec playwright install chromium webkit --with-deps)
 pnpm run check       # biome lint + format
-pnpm run build       # build dist/index.html (dev-time, uses tsx + esbuild)
 ```
 
 ## FAQ