Lesss gooo claude

CLAUDE.md

@@ -4,7 +4,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Repository state
 
-This repo currently contains only a spec (`NEXA_SPEC.md`), `README.md`, and `LICENSE` — no source code, `package.json`, or `manifest.json` exist yet. There are no build/lint/test commands to run because nothing has been scaffolded. When implementation begins, this file should be updated with the actual commands (build, lint, test, load-unpacked instructions) once a package manager and bundler are chosen.
+Scaffolded with [WXT](https://wxt.dev) (Vite-based, TypeScript-first, built on top of `webextension-polyfill` for the cross-browser `browser.*` API) — the popular framework for building Manifest V3 extensions that target both Firefox and Chromium from one codebase. Package manager: npm.
+
+Commands:
+- `npm install` — install deps (also runs `wxt prepare` via `postinstall` to generate `.wxt/` types).
+- `npm run dev` — dev build + watch, targets Chromium by default.
+- `npm run dev:firefox` — dev build + watch targeting Firefox (use this for Zen).
+- `npm run build` / `npm run build:firefox` — production build, output in `.output/chrome-mv3/` or `.output/firefox-mv3/`.
+- `npm run compile` — `tsc --noEmit` type-check only.
+- `npm run zip` / `npm run zip:firefox` — production build packaged as a `.zip` for store upload.
+
+Load-unpacked: run a build, then in Chromium go to `chrome://extensions` → enable Developer Mode → "Load unpacked" → select `.output/chrome-mv3/`. In Firefox/Zen go to `about:debugging#/runtime/this-firefox` → "Load Temporary Add-on" → select any file inside `.output/firefox-mv3/` (or use `npm run dev:firefox`, which auto-opens a temporary profile with the extension loaded).
+
+There is no lint/test setup yet — add one when the project needs it rather than pre-emptively scaffolding.
 
 ## What this project is