---
description: Use Bun for this repo (install, run, build); bunx for Convex CLI and one-off tools.
alwaysApply: true
---

# Package manager: Bun

This project uses **Bun** (`bun.lock`). Do **not** use `npm install`, `npm run`, or `npx` for local work or mesh-forge CI unless there is no reasonable Bun equivalent.

- **Install:** `bun install`
- **Scripts:** `bun run <script>` (e.g. `bun run dev`, `bun run build`)
- **Convex CLI:** `bunx convex ...` (e.g. `bunx convex dev`, `bunx convex deploy`). **Never** `bunx convex codegen` — see `convex-no-codegen.mdc`.
- **Other one-shot CLIs:** prefer `bunx <pkg>` over `npx`

If both `package-lock.json` and `bun.lock` appear, **remove `package-lock.json`** and standardize on Bun.

Sample vendored trees under `samples/projects/` may use their own package manager; do not change those unless the task is explicitly about them.