From ff8bf5905e457957ad0587c7152b415131ff7d26 Mon Sep 17 00:00:00 2001
From: Myles Scolnick <myles@marimo.io>
Date: Wed, 22 Jul 2026 16:12:30 -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..fe4f813
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,18 @@
+# mkdocs-marimo
+
+MkDocs plugin that renders reactive marimo cells in Markdown docs. Published to PyPI as `mkdocs-marimo`.
+
+## Development
+
+Tooling is driven by [pixi](https://pixi.sh) (all tasks defined in `pixi.toml`):
+
+```bash
+pixi run postinstall           # editable install into the env
+pixi run test                  # pytest
+pixi run mypy mkdocs_marimo    # type check
+pixi run pre-commit-run        # lint/format (ruff, taplo, typos) — matches CI lint job
+pixi run docs                  # serve docs locally (pixi run docs-build to build)
+```
+
+- CI runs `test` + `mypy` across the `py39`–`py313` environments (`pixi run -e py312 test`).
+- No pixi? These map to `pytest`, `mypy`, and `pre-commit run -a` under the env deps in `pixi.toml`.
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