From d04702c1339055478c6b9dd5c507735903d5ca93 Mon Sep 17 00:00:00 2001
From: Myles Scolnick <myles@marimo.io>
Date: Wed, 22 Jul 2026 16:12:12 -0400
Subject: [PATCH] docs: add AGENTS.md with CLAUDE.md symlink

---
 AGENTS.md | 18 ++++++++++++++++++
 CLAUDE.md |  1 +
 2 files changed, 19 insertions(+)
 create mode 100644 AGENTS.md
 create mode 120000 CLAUDE.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a9ea775
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,18 @@
+# codemirror-sql
+
+CodeMirror 6 extension for SQL: real-time linting, gutter indicators, hover tooltips, and schema-aware autocomplete (DuckDB, BigQuery, Dremio dialects). Published to npm as `@marimo-team/codemirror-sql` and used by marimo's editor.
+
+## Development
+
+```bash
+pnpm install --ignore-scripts --frozen-lockfile  # CI install
+pnpm test              # vitest
+pnpm run test:browser  # vitest browser tests (Playwright)
+pnpm run lint          # oxlint --fix (autofix.ci runs this on PRs)
+pnpm exec oxlint       # non-mutating lint CI enforces
+pnpm run typecheck     # tsc --noEmit
+pnpm run demo          # vite build of demo/
+```
+
+- Browser tests need Playwright browsers installed first: `pnpm exec playwright install`.
+- Release: `pnpm run release` (pnpm version) bumps + tags; pushing a `v*` tag triggers release.yml, which publishes to npm via OIDC.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 120000
index 0000000..47dc3e3
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+AGENTS.md
\ No newline at end of file