Skip to content

Commit 8220b9f

Browse files
Brian M HuntBrian M Hunt
authored andcommitted
docs(agents): spell out tooling conventions (bunx, Bun-native APIs)
Three short lines added under Prerequisites so these conventions live in the canonical agent context file instead of scattered session memory: - `bunx` over `npx`. - Prefer native Bun APIs (Bun.Glob, Bun.file, Bun.write, Bun.$) over node:fs in repo scripts. Runtime is pinned by .tool-versions, so there's no Node-portability concern. - Browser automation uses `bunx @playwright/cli` (not the deprecated `playwright-cli` package, not `npx playwright`).
1 parent 4e20972 commit 8220b9f

1 file changed

Lines changed: 3 additions & 1 deletion

File tree

AGENTS.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,9 @@ Builds: `@tko/build.knockout` (backwards-compatible) and
4343
## Prerequisites
4444

4545
- **Bun** — package manager and script runner. Install via [mise](https://mise.jdx.dev/): `mise install` (reads `.tool-versions`), or [bun.sh](https://bun.sh).
46-
- Use `bun install` instead of `npm install`.
46+
- Use `bun install` instead of `npm install`; `bunx` instead of `npx`.
47+
- In repo scripts (`tko.io/scripts`, `tools/`, `builds/*/build.ts`), prefer native Bun APIs — `Bun.Glob`, `Bun.file`, `Bun.write`, `Bun.$` — over `node:fs`, `node:fs/promises.glob`, or ad-hoc `child_process`. Runtime is pinned by `.tool-versions`, so there's no Node-version portability concern.
48+
- Browser automation uses `bunx @playwright/cli <cmd>` (not `npx playwright`, not the deprecated `playwright-cli` package).
4749

4850
## Build Commands
4951

0 commit comments

Comments
 (0)