{"owner":"supabase","repo":"supabase-js","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md"],"skills":{"AGENTS.md":"# Agent instructions\n\nEntry point for AI/LLM agents working in or with this repository. Pointers below; nothing canonical lives in this file.\n\n## Repository overview\n\n- [`README.md`](./README.md) — what this repo is, package list, quick start\n- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — contribution guidelines, commit format, PR process\n- [`.claude/CLAUDE.md`](./.claude/CLAUDE.md) — development conventions, Nx commands, testing matrix, library-specific notes (read by Claude Code; the canonical development-conventions doc)\n- [`.cursor/.cursorrules`](./.cursor/.cursorrules) — same conventions for Cursor (read by Cursor IDE)\n\n## Agent skills\n\nReusable agent skills for working in this Nx workspace (Nx-related: `nx-workspace`, `nx-generate`, `nx-import`, `nx-plugins`, `nx-run-tasks`, `link-workspace-packages`) live at:\n\n- [`.agents/skills/`](./.agents/skills/) — vendor-neutral location (Agent Skills spec)\n- [`.claude/skills/`](./.claude/skills/) — mirrored copy read by Claude Code by literal path\n\nBoth directories currently hold the same content. Treat `.agents/skills/` as the source of truth; the `.claude/skills/` copy is kept in sync until Claude Code can discover skills from `.agents/skills/` directly.\n\n## Per-package usage\n\nEach package has its own README with usage examples and API notes:\n\n- [`packages/core/supabase-js/README.md`](./packages/core/supabase-js/README.md) — `@supabase/supabase-js` (main isomorphic client)\n- [`packages/core/auth-js/README.md`](./packages/core/auth-js/README.md) — `@supabase/auth-js`\n- [`packages/core/postgrest-js/README.md`](./packages/core/postgrest-js/README.md) — `@supabase/postgrest-js`\n- [`packages/core/realtime-js/README.md`](./packages/core/realtime-js/README.md) — `@supabase/realtime-js`\n- [`packages/core/storage-js/README.md`](./packages/core/storage-js/README.md) — `@supabase/storage-js`\n- [`packages/core/functions-js/README.md`](./packages/core/functions-js/README.md) — `@supabase/functions-js`\n\n## Helping users of a published `@supabase/*` package\n\nThe published npm tarball for each package ships everything an agent needs to give a correct, version-pinned answer. After `npm install @supabase/<package>`, an agent helping with that package should look inside `node_modules/@supabase/<package>/`:\n\n- `AGENTS.md` — per-package agent entry point (read this first; it points at the resources below).\n- `README.md` — usage and quick-start.\n- `src/` — full API source with TSDoc. Every public method and type has JSDoc, most have `@example` blocks. Read source here for the canonical, version-pinned answer instead of guessing from training data.\n- `migrations/` — per-theme migration notes for changes that need caller action.\n\nSource files ship via npm because every package's `files` array in `package.json` includes `\"src\"`. Migration notes ship via `\"migrations\"`. Per-package `AGENTS.md` ships via `\"AGENTS.md\"`. All three are version-pinned by virtue of being inside the installed package.\n\nWe deliberately do NOT ship per-package skills or duplicate docs-site content. The TSDoc-in-source IS the canonical API documentation for the SDK packages.\n\nFor higher-level Supabase guidance (the documentation site, MCP tools, schema management workflows, project setup), use the centralized [Supabase agent skills](https://github.com/supabase/agent-skills):\n\n```bash\nnpx skills add supabase/agent-skills\n```\n\nOr use the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins) to install the agent skills together with the Supabase MCP server in one step. See also: [Agent Skills documentation](https://agentskills.io/home).\n\n## Migration notes\n\nMigration notes live close to the code they describe, so they ship via npm alongside the package.\n\n- **Per-package migrations**: `packages/core/<package>/migrations/<theme>.md` — one file per migration theme (e.g. `<new-feature-adoption>.md`). Each file describes what changed, who is affected, and what callers need to do.\n- **Cross-cutting migrations** (affecting the whole repo or all packages): [`docs/MIGRATION.md`](./docs/MIGRATION.md) — one H2 section per theme (e.g. Node.js version drops). Low-frequency by design; split into a directory only if the file grows past a handful of themes.\n\n## Other documentation\n\n- [`docs/TESTING.md`](./docs/TESTING.md) — testing guide with Docker requirements per package\n- [`docs/RELEASE.md`](./docs/RELEASE.md) — release workflows and versioning strategy\n- [`docs/SECURITY.md`](./docs/SECURITY.md) — security policies and responsible disclosure\n- [`docs/JSR_PUBLISHING.md`](./docs/JSR_PUBLISHING.md) — JSR registry publishing\n"},"files":{"AGENTS.md":"# Agent instructions\n\nEntry point for AI/LLM agents working in or with this repository. Pointers below; nothing canonical lives in this file.\n\n## Repository overview\n\n- [`README.md`](./README.md) — what this repo is, package list, quick start\n- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — contribution guidelines, commit format, PR process\n- [`.claude/CLAUDE.md`](./.claude/CLAUDE.md) — development conventions, Nx commands, testing matrix, library-specific notes (read by Claude Code; the canonical development-conventions doc)\n- [`.cursor/.cursorrules`](./.cursor/.cursorrules) — same conventions for Cursor (read by Cursor IDE)\n\n## Agent skills\n\nReusable agent skills for working in this Nx workspace (Nx-related: `nx-workspace`, `nx-generate`, `nx-import`, `nx-plugins`, `nx-run-tasks`, `link-workspace-packages`) live at:\n\n- [`.agents/skills/`](./.agents/skills/) — vendor-neutral location (Agent Skills spec)\n- [`.claude/skills/`](./.claude/skills/) — mirrored copy read by Claude Code by literal path\n\nBoth directories currently hold the same content. Treat `.agents/skills/` as the source of truth; the `.claude/skills/` copy is kept in sync until Claude Code can discover skills from `.agents/skills/` directly.\n\n## Per-package usage\n\nEach package has its own README with usage examples and API notes:\n\n- [`packages/core/supabase-js/README.md`](./packages/core/supabase-js/README.md) — `@supabase/supabase-js` (main isomorphic client)\n- [`packages/core/auth-js/README.md`](./packages/core/auth-js/README.md) — `@supabase/auth-js`\n- [`packages/core/postgrest-js/README.md`](./packages/core/postgrest-js/README.md) — `@supabase/postgrest-js`\n- [`packages/core/realtime-js/README.md`](./packages/core/realtime-js/README.md) — `@supabase/realtime-js`\n- [`packages/core/storage-js/README.md`](./packages/core/storage-js/README.md) — `@supabase/storage-js`\n- [`packages/core/functions-js/README.md`](./packages/core/functions-js/README.md) — `@supabase/functions-js`\n\n## Helping users of a published `@supabase/*` package\n\nThe published npm tarball for each package ships everything an agent needs to give a correct, version-pinned answer. After `npm install @supabase/<package>`, an agent helping with that package should look inside `node_modules/@supabase/<package>/`:\n\n- `AGENTS.md` — per-package agent entry point (read this first; it points at the resources below).\n- `README.md` — usage and quick-start.\n- `src/` — full API source with TSDoc. Every public method and type has JSDoc, most have `@example` blocks. Read source here for the canonical, version-pinned answer instead of guessing from training data.\n- `migrations/` — per-theme migration notes for changes that need caller action.\n\nSource files ship via npm because every package's `files` array in `package.json` includes `\"src\"`. Migration notes ship via `\"migrations\"`. Per-package `AGENTS.md` ships via `\"AGENTS.md\"`. All three are version-pinned by virtue of being inside the installed package.\n\nWe deliberately do NOT ship per-package skills or duplicate docs-site content. The TSDoc-in-source IS the canonical API documentation for the SDK packages.\n\nFor higher-level Supabase guidance (the documentation site, MCP tools, schema management workflows, project setup), use the centralized [Supabase agent skills](https://github.com/supabase/agent-skills):\n\n```bash\nnpx skills add supabase/agent-skills\n```\n\nOr use the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins) to install the agent skills together with the Supabase MCP server in one step. See also: [Agent Skills documentation](https://agentskills.io/home).\n\n## Migration notes\n\nMigration notes live close to the code they describe, so they ship via npm alongside the package.\n\n- **Per-package migrations**: `packages/core/<package>/migrations/<theme>.md` — one file per migration theme (e.g. `<new-feature-adoption>.md`). Each file describes what changed, who is affected, and what callers need to do.\n- **Cross-cutting migrations** (affecting the whole repo or all packages): [`docs/MIGRATION.md`](./docs/MIGRATION.md) — one H2 section per theme (e.g. Node.js version drops). Low-frequency by design; split into a directory only if the file grows past a handful of themes.\n\n## Other documentation\n\n- [`docs/TESTING.md`](./docs/TESTING.md) — testing guide with Docker requirements per package\n- [`docs/RELEASE.md`](./docs/RELEASE.md) — release workflows and versioning strategy\n- [`docs/SECURITY.md`](./docs/SECURITY.md) — security policies and responsible disclosure\n- [`docs/JSR_PUBLISHING.md`](./docs/JSR_PUBLISHING.md) — JSR registry publishing\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Agent instructions\n\nEntry point for AI/LLM agents working in or with this repository. Pointers below; nothing canonical lives in this file.\n\n## Repository overview\n\n- [`README.md`](./README.md) — what this repo is, package list, quick start\n- [`CONTRIBUTING.md`](./CONTRIBUTING.md) — contribution guidelines, commit format, PR process\n- [`.claude/CLAUDE.md`](./.claude/CLAUDE.md) — development conventions, Nx commands, testing matrix, library-specific notes (read by Claude Code; the canonical development-conventions doc)\n- [`.cursor/.cursorrules`](./.cursor/.cursorrules) — same conventions for Cursor (read by Cursor IDE)\n\n## Agent skills\n\nReusable agent skills for working in this Nx workspace (Nx-related: `nx-workspace`, `nx-generate`, `nx-import`, `nx-plugins`, `nx-run-tasks`, `link-workspace-packages`) live at:\n\n- [`.agents/skills/`](./.agents/skills/) — vendor-neutral location (Agent Skills spec)\n- [`.claude/skills/`](./.claude/skills/) — mirrored copy read by Claude Code by literal path\n\nBoth directories currently hold the same content. Treat `.agents/skills/` as the source of truth; the `.claude/skills/` copy is kept in sync until Claude Code can discover skills from `.agents/skills/` directly.\n\n## Per-package usage\n\nEach package has its own README with usage examples and API notes:\n\n- [`packages/core/supabase-js/README.md`](./packages/core/supabase-js/README.md) — `@supabase/supabase-js` (main isomorphic client)\n- [`packages/core/auth-js/README.md`](./packages/core/auth-js/README.md) — `@supabase/auth-js`\n- [`packages/core/postgrest-js/README.md`](./packages/core/postgrest-js/README.md) — `@supabase/postgrest-js`\n- [`packages/core/realtime-js/README.md`](./packages/core/realtime-js/README.md) — `@supabase/realtime-js`\n- [`packages/core/storage-js/README.md`](./packages/core/storage-js/README.md) — `@supabase/storage-js`\n- [`packages/core/functions-js/README.md`](./packages/core/functions-js/README.md) — `@supabase/functions-js`\n\n## Helping users of a published `@supabase/*` package\n\nThe published npm tarball for each package ships everything an agent needs to give a correct, version-pinned answer. After `npm install @supabase/<package>`, an agent helping with that package should look inside `node_modules/@supabase/<package>/`:\n\n- `AGENTS.md` — per-package agent entry point (read this first; it points at the resources below).\n- `README.md` — usage and quick-start.\n- `src/` — full API source with TSDoc. Every public method and type has JSDoc, most have `@example` blocks. Read source here for the canonical, version-pinned answer instead of guessing from training data.\n- `migrations/` — per-theme migration notes for changes that need caller action.\n\nSource files ship via npm because every package's `files` array in `package.json` includes `\"src\"`. Migration notes ship via `\"migrations\"`. Per-package `AGENTS.md` ships via `\"AGENTS.md\"`. All three are version-pinned by virtue of being inside the installed package.\n\nWe deliberately do NOT ship per-package skills or duplicate docs-site content. The TSDoc-in-source IS the canonical API documentation for the SDK packages.\n\nFor higher-level Supabase guidance (the documentation site, MCP tools, schema management workflows, project setup), use the centralized [Supabase agent skills](https://github.com/supabase/agent-skills):\n\n```bash\nnpx skills add supabase/agent-skills\n```\n\nOr use the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins) to install the agent skills together with the Supabase MCP server in one step. See also: [Agent Skills documentation](https://agentskills.io/home).\n\n## Migration notes\n\nMigration notes live close to the code they describe, so they ship via npm alongside the package.\n\n- **Per-package migrations**: `packages/core/<package>/migrations/<theme>.md` — one file per migration theme (e.g. `<new-feature-adoption>.md`). Each file describes what changed, who is affected, and what callers need to do.\n- **Cross-cutting migrations** (affecting the whole repo or all packages): [`docs/MIGRATION.md`](./docs/MIGRATION.md) — one H2 section per theme (e.g. Node.js version drops). Low-frequency by design; split into a directory only if the file grows past a handful of themes.\n\n## Other documentation\n\n- [`docs/TESTING.md`](./docs/TESTING.md) — testing guide with Docker requirements per package\n- [`docs/RELEASE.md`](./docs/RELEASE.md) — release workflows and versioning strategy\n- [`docs/SECURITY.md`](./docs/SECURITY.md) — security policies and responsible disclosure\n- [`docs/JSR_PUBLISHING.md`](./docs/JSR_PUBLISHING.md) — JSR registry publishing\n","category":"root","tokens":1157}]}