💬 Commit message: Update 2026-02-06 20:32:18, 7 files, 781 lines

📁 Files changed: 7
📝 Lines changed: 781

  • CLAUDE.md
  • biome.json
  • package-lock.json
  • package.json
  • browser.ts
  • cli.ts
  • server.ts

CLAUDE.md

@@ -5,13 +5,36 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 ## Build & Development
 
 ```bash
-npm install                  # Install dependencies
+npm install                    # Install dependencies
 npx playwright install webkit  # Install WebKit browser
-npm run build                # Compile TypeScript to dist/
-npm run dev                  # Watch mode compilation
-npm start                    # Run the CLI (after build)
+npm run build                  # Compile TypeScript to dist/
+npm run dev                    # Watch mode compilation
+npm start                      # Run the CLI (after build)
 ```
 
+## Lint, Format & Typecheck
+
+```bash
+npm run check                  # Run all checks (lint + format)
+npm run fix                    # Fix all auto-fixable issues
+npm run lint                   # Lint only
+npm run lint:fix               # Lint with autofix
+npm run format                 # Check formatting
+npm run format:fix             # Fix formatting
+npm run typecheck              # TypeScript type checking
+```
+
+## Code Style
+
+- **Short methods**: Keep methods under 20 lines. Extract logic into focused helper methods.
+- **Single responsibility**: Each class handles one concern. Split large classes by domain.
+- **Class structure**:
+  - `ClaudeBrowser` - browser lifecycle and page interactions
+  - `BrowserServer` - HTTP server and request handling
+  - `Logger` (planned) - colored console output
+- **Naming**: Commands use `verbNoun` pattern (e.g., `getCookies`, `setStorage`).
+- **Types**: All commands in discriminated union. Add new commands to `BrowserCommand` type.
+
 ## Architecture
 
 This is a TypeScript library providing headless browser automation via Playwright WebKit. It has three modes of operation: