Menu
Use when running repo scripts, adding or changing dependencies, editing package.json files, installing packages, or deciding how Bun workspace commands should be invoked in this monorepo.
| name | tooling-and-dependencies |
| description | Use when running repo scripts, adding or changing dependencies, editing package.json files, installing packages, or deciding how Bun workspace commands should be invoked in this monorepo. |
bun exclusively for commands and package operations.npm, pnpm, npx, or other package runners unless there is a
specific reason and you explain it..ts files without a
separate compile step.This monorepo uses Bun's workspaces.catalog in the root package.json.
package.json by
default.package.json under
workspaces.catalog, for example "new-package": "1.2.3"."new-package": "catalog:".bun add <package> inside a package directory; it writes direct
versions and breaks the catalog pattern.apps/docs should use catalog versions; published packages such as
packages/diffs may use ranges only when that is intentional.bun ws <project> <task>
bun ws <project> <task> --some --flag
bun ws forwards arguments to the target script and does not require a
standalone -- separator. The only special handling is that -v and
--verbose are consumed by scripts/ws.ts.
Use when preparing, splitting, reviewing, or creating git commits in this repo, especially after larger implementations that should be broken into independently verified commits.
Use when opening, inspecting, clicking, filling, snapshotting, or otherwise automating web pages for this repo, including local dev servers and browser-based verification.
Use when changing loops, collection processing, invalidation logic, tree/diff traversal, path scanning, virtualized rendering calculations, or any code where repeated scans or boolean control flow affect performance or correctness.
Use when adding or running tests, checking snapshots, choosing between Bun tests and Playwright, running lint/format/typecheck, or deciding the verification scope for a change.
Use when adding or changing packages/apps, TypeScript configs, workspace dependencies, package references, exports, or monorepo project-reference relationships.
Use when working with the repo's bun run wt helper, Pierre-managed worktrees, dev-server port offsets, stale server cleanup, Playwright fixtures, or Chrome debug instances. Do not use this as a substitute for host-provided workspace isolation.