agentlink-sh 0.31.0 → 0.32.0

package/README.md

@@ -377,7 +377,7 @@ The scaffold runs a multi-step process:
 7. **Verify setup** — Runs verification queries to confirm all components
 8. **Setup frontend** — Writes React + Vite or NextJS files (if selected)
 9. **Install frontend deps** — Runs `npm install` for the frontend
-10. **Configure Claude Code** — Sets up `CLAUDE.md` and Claude settings
+10. **Configure Claude Code** — Sets up `AGENTS.md` and Claude settings
 11. **Install MCP** — Installs Supabase MCP server (local mode only)
 12. **Install plugin** — Installs Agent Link plugin and companion skills
 13. **Finalize** — Creates git repo, writes `agentlink.json` manifest
@@ -425,7 +425,7 @@ The CLI installs all recommended companion skills for Claude Code automatically.
 ```
 my-app/
 ├── agentlink.json                  # Project manifest
-├── CLAUDE.md                       # AI agent instructions
+├── AGENTS.md                       # AI agent instructions
 ├── .env.local                      # Environment variables
 ├── .env.example
 ├── .claude/

package/dist/index.js

@@ -6494,7 +6494,7 @@ async function countTargetUserTables(projectRef) {
   }
 }
 
-// src/claude-md.ts
+// src/agents-md.ts
 import fs8 from "fs";
 import path8 from "path";
 var MARKER_START = "<!-- agentlink:config:start -->";
@@ -6610,8 +6610,8 @@ Run \`supabase status\` to get the local API URL, DB URL, publishable key, and s
   return `${MARKER_START}
 ${content}${MARKER_END}`;
 }
-function writeClaudeMd(options) {
-  const filePath = path8.join(options.projectDir, "CLAUDE.md");
+function writeAgentsMd(options) {
+  const filePath = path8.join(options.projectDir, "AGENTS.md");
   const section = generateSection(options);
   if (!fs8.existsSync(filePath)) {
     fs8.writeFileSync(filePath, section + "\n");
@@ -6796,7 +6796,7 @@ function writeBareManifest(cwd) {
     // `mode: "bare"` is diagnostic only — `setDefaultEnvironment` in
     // manifest.ts will overwrite it to "cloud" on the first `env add dev`.
     // The DURABLE flag is `bare: true` below: it's orthogonal to mode and
-    // survives every env mutation, so downstream checks (CLAUDE.md guards,
+    // survives every env mutation, so downstream checks (AGENTS.md guards,
     // envDeploy sequence) can reliably detect "this project isn't
     // scaffolded" regardless of what `mode` says right now.
     mode: "bare",
@@ -7017,14 +7017,14 @@ async function envAdd(name, cwd, opts = {}) {
     setDefaultEnvironment(cwd, name);
     console.log(`  ${blue("\u2714")} Default environment set to "${name}"`);
     if (!bare) {
-      writeClaudeMd({
+      writeAgentsMd({
         projectDir: cwd,
         mode: "cloud",
         projectRef: env2.projectRef,
         region: env2.region,
         envName: name
       });
-      console.log(`  ${blue("\u2714")} CLAUDE.md regenerated for "${name}"`);
+      console.log(`  ${blue("\u2714")} AGENTS.md regenerated for "${name}"`);
     }
   }
   let shouldDeploy;
@@ -7478,10 +7478,10 @@ async function envUse(name, cwd) {
   const updatedManifest = readManifest(cwd);
   if (!isBareManifest(updatedManifest)) {
     if (name === "local") {
-      writeClaudeMd({ projectDir: cwd, mode: "local" });
+      writeAgentsMd({ projectDir: cwd, mode: "local" });
     } else {
       const env2 = updatedManifest.cloud.environments[name];
-      writeClaudeMd({
+      writeAgentsMd({
         projectDir: cwd,
         mode: "cloud",
         projectRef: env2.projectRef,
@@ -7489,7 +7489,7 @@ async function envUse(name, cwd) {
         envName: name
       });
     }
-    console.log(`  ${blue("\u2714")} CLAUDE.md regenerated for ${name} mode`);
+    console.log(`  ${blue("\u2714")} AGENTS.md regenerated for ${name} mode`);
   }
   console.log(`
   ${blue(isRefresh ? "Refreshed" : "Switched to")} ${bold(name)}`);
@@ -7701,17 +7701,17 @@ async function envRelink(name, cwd, opts = {}) {
     });
     console.log(`  ${blue("\u2714")} .env.local updated (pooler URL from API)`);
     if (!isBareManifest(manifest)) {
-      writeClaudeMd({
+      writeAgentsMd({
         projectDir: cwd,
         mode: "cloud",
         projectRef: env2.projectRef,
         region: env2.region,
         envName: name
       });
-      console.log(`  ${blue("\u2714")} CLAUDE.md updated`);
+      console.log(`  ${blue("\u2714")} AGENTS.md updated`);
     }
   } else {
-    console.log(`  ${dim(`.env.local and CLAUDE.md left on the active env \u2014 prod never auto-activates (use \`env use prod\` to switch).`)}`);
+    console.log(`  ${dim(`.env.local and AGENTS.md left on the active env \u2014 prod never auto-activates (use \`env use prod\` to switch).`)}`);
   }
   if (opts.deploy === false) {
     const deployCmd = `npx agentlink-sh@latest env deploy ${name}`;
@@ -11781,7 +11781,7 @@ SUPABASE_DB_PASSWORD=${ctx.dbPass}
   await trackedStep("configure-claude", "Configuring Claude Code", async () => {
     ensureClaudeSettings(projectDir, !!options.cloud || !!options.skipEnv);
     const mode2 = options.skipEnv ? "pending-env" : options.cloud ? "cloud" : "local";
-    writeClaudeMd({
+    writeAgentsMd({
       projectDir,
       mode: mode2,
       projectRef: ctx.projectRef,
@@ -12086,8 +12086,8 @@ ${red("Error:")} Supabase is not running.
       projectDir
     );
   });
-  await step("Updating CLAUDE.md", async () => {
-    writeClaudeMd({
+  await step("Updating AGENTS.md", async () => {
+    writeAgentsMd({
       projectDir,
       mode: isCloud ? "cloud" : "local",
       projectRef: env2?.projectRef,
@@ -12284,7 +12284,7 @@ async function runDryRun(projectDir, isCloud) {
   console.log(`
   ${bold("Side effects")} ${dim("(skipped in dry run)")}`);
   console.log(`    ${dim("\u2022")} update agent plugin + companion skills`);
-  console.log(`    ${dim("\u2022")} rewrite .claude/CLAUDE.md, .claude/settings.json`);
+  console.log(`    ${dim("\u2022")} rewrite AGENTS.md, .claude/settings.json`);
   console.log(`    ${dim("\u2022")} apply ${sqlCount} SQL schema file(s) to ${isCloud ? "cloud DB" : "local DB"}`);
   if (isCloud) {
     console.log(`    ${dim("\u2022")} update PostgREST config + auth config`);
@@ -12318,7 +12318,7 @@ async function printUpdateSummary(projectDir, allowDirty) {
     // config.toml, .gitignore
     ".claude/": [],
     "root": []
-    // agentlink.json, CLAUDE.md, .env.local, etc.
+    // agentlink.json, AGENTS.md, .env.local, etc.
   };
   for (const file of changed) {
     if (file.startsWith("supabase/schemas/")) groups["supabase/schemas/"].push(file);
@@ -13540,7 +13540,7 @@ env.command("add [name]").description("Add or re-add a cloud environment (dev or
     console.log();
     console.log(`  ${bold("To use local development:")}`);
     console.log(`    ${dim("supabase start")}                          ${dim("# bring up the local Docker stack")}`);
-    console.log(`    ${dim("npx agentlink-sh@latest env use local")}   ${dim("# point .env.local + CLAUDE.md at it")}`);
+    console.log(`    ${dim("npx agentlink-sh@latest env use local")}   ${dim("# point .env.local + AGENTS.md at it")}`);
     console.log();
     console.log(`  ${dim("Or scaffold a new project against local Docker:")} ${dim("npx agentlink-sh@latest <name> --local")}`);
     console.log();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentlink-sh",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "CLI for building Supabase apps with AI agents",
   "bin": {
     "agentlink": "dist/index.js"