AGENTS.md

1# CLAUDE.md
2 
3This repository ships `dev-browser`: a Rust CLI plus a Node.js daemon for browser automation with a QuickJS sandbox. Use this file as the repo-specific guide when making code changes.
4 
5## Tooling
6 
7- Use Node.js tooling for `daemon/` and Cargo for `cli/`. Do not use Bun.
8- The daemon package uses `pnpm`.
9- The repo root contains packaging glue (`bin/`, `scripts/`, `README.md`), but most runtime behavior lives in `cli/` and `daemon/`.
10 
11## Validation
12 
13Run these before finishing changes that touch runtime code:
14 
15```bash
16cd daemon && npx tsc --noEmit
17cd daemon && pnpm vitest run
18cd cli && cargo build
19```
20 
21If you change daemon runtime code that is embedded into the Rust binary, rebuild the bundles first:
22 
23```bash
24cd daemon && pnpm bundle
25cd daemon && pnpm bundle:sandbox-client
26```
27 
28`cli/src/daemon.rs` embeds `daemon/dist/daemon.bundle.mjs` and `daemon/dist/sandbox-client.js` via `include_str!`, so `cargo build` only sees the latest daemon changes after those bundles are regenerated.
29