From f5670f24e8a5c1728867c275d8416749c411dea9 Mon Sep 17 00:00:00 2001
From: Ramon Nogueira <ramon.nogueira@langchain.dev>
Date: Mon, 29 Jun 2026 16:17:14 -0400
Subject: [PATCH] chore: require bun for ui agent work (#1639)

Co-authored-by: Ramon Nogueira <270434257+ramon-langchain@users.noreply.github.com>
Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
---
 ui/AGENTS.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 ui/AGENTS.md

diff --git a/ui/AGENTS.md b/ui/AGENTS.md
new file mode 100644
index 00000000..f9e31337
--- /dev/null
+++ b/ui/AGENTS.md
@@ -0,0 +1,12 @@
+# AGENTS.md
+
+This file applies to all work under `ui/`.
+
+## Package manager
+
+- Use **Bun** for dashboard dependency management and script execution.
+- `bun.lock` is the canonical lockfile for this directory.
+- Run UI scripts with `bun run <script>` (for example, `bun run typecheck`, `bun run lint`, `bun run test`, `bun run build`).
+- Install or update UI dependencies with `bun install` / `bun add` only.
+- Do **not** use npm in this directory: no `npm install`, `npm ci`, `npm run`, `npx`, or npm lockfile changes.
+- If a command must use npm, it belongs outside `ui/` in a subtree that explicitly owns npm configuration and lockfiles.