agentinit 1.26.0 → 1.27.0

package/dist/cli.js

@@ -8501,6 +8501,89 @@ var init_logger = __esm(() => {
 });
 
 // dist/utils/fs.js
+var exports_fs = {};
+__export(exports_fs, {
+  writeFile: () => {
+    {
+      return writeFile;
+    }
+  },
+  resolveRealPathOrSelf: () => {
+    {
+      return resolveRealPathOrSelf;
+    }
+  },
+  resolveParentSymlinks: () => {
+    {
+      return resolveParentSymlinks;
+    }
+  },
+  readSymlinkTarget: () => {
+    {
+      return readSymlinkTarget;
+    }
+  },
+  readFileIfExists: () => {
+    {
+      return readFileIfExists;
+    }
+  },
+  pathsReferToSameLocation: () => {
+    {
+      return pathsReferToSameLocation;
+    }
+  },
+  pathExists: () => {
+    {
+      return pathExists;
+    }
+  },
+  listFiles: () => {
+    {
+      return listFiles;
+    }
+  },
+  isDirectory: () => {
+    {
+      return isDirectory;
+    }
+  },
+  getAgentInitTomlPath: () => {
+    {
+      return getAgentInitTomlPath;
+    }
+  },
+  findFiles: () => {
+    {
+      return findFiles;
+    }
+  },
+  fileExists: () => {
+    {
+      return fileExists;
+    }
+  },
+  ensureDirectoryExists: () => {
+    {
+      return ensureDirectoryExists;
+    }
+  },
+  ensureAgentInitDir: () => {
+    {
+      return ensureAgentInitDir;
+    }
+  },
+  createRelativeSymlink: () => {
+    {
+      return createRelativeSymlink;
+    }
+  },
+  copyFile: () => {
+    {
+      return copyFile;
+    }
+  }
+});
 import {promises as fs} from "fs";
 import {platform} from "os";
 import {join, dirname, basename, resolve, relative} from "path";
@@ -19178,6 +19261,139 @@ var init_pluginManager = __esm(() => {
   };
 });
 
+// dist/utils/http.js
+async function fetchWithTimeout(url, options2 = {}) {
+  const { timeout = 30000, ...fetchOptions } = options2;
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), timeout);
+  try {
+    const response = await fetch(url, {
+      ...fetchOptions,
+      signal: controller.signal
+    });
+    return response;
+  } catch (error) {
+    if (error instanceof Error && error.name === "AbortError") {
+      throw new HttpTimeoutError(url, timeout);
+    }
+    throw error;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+class HttpTimeoutError extends Error {
+  constructor(url, timeoutMs) {
+    super(`Request to ${url} timed out after ${timeoutMs}ms`);
+    this.name = "HttpTimeoutError";
+  }
+}
+var init_http = __esm(() => {
+});
+
+// dist/core/wellKnownDiscovery.js
+var exports_wellKnownDiscovery = {};
+__export(exports_wellKnownDiscovery, {
+  WellKnownDiscoveryError: () => {
+    {
+      return WellKnownDiscoveryError;
+    }
+  },
+  WellKnownDiscovery: () => {
+    {
+      return WellKnownDiscovery;
+    }
+  }
+});
+
+class WellKnownDiscoveryError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WellKnownDiscoveryError";
+  }
+}
+
+class WellKnownDiscovery {
+  async discover(baseUrl) {
+    const urls = this.getCandidateUrls(baseUrl);
+    const errors = [];
+    for (const url of urls) {
+      try {
+        const response = await fetchWithTimeout(url, { timeout: 1e4 });
+        if (!response.ok) {
+          errors.push(`${url}: ${response.status} ${response.statusText}`);
+          continue;
+        }
+        const data = await response.json();
+        const parsed = this.parseIndex(data);
+        if (!parsed) {
+          errors.push(`${url}: invalid response structure`);
+          continue;
+        }
+        return parsed.skills;
+      } catch (error) {
+        errors.push(`${url}: ${error instanceof Error ? error.message : "unknown error"}`);
+      }
+    }
+    throw new WellKnownDiscoveryError(`Failed to discover skills from ${baseUrl}. Attempted URLs:\n${errors.map((e) => `  - ${e}`).join("\n")}`);
+  }
+  getCandidateUrls(source) {
+    let parsed;
+    try {
+      parsed = new URL(source);
+    } catch {
+      throw new WellKnownDiscoveryError(`Invalid URL: ${source}`);
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+      throw new WellKnownDiscoveryError(`Unsupported URL protocol: ${parsed.protocol}`);
+    }
+    const urls = [];
+    const normalizedInput = parsed.toString();
+    const path = parsed.pathname.replace(/\/+$/, "");
+    if (path && path !== "/") {
+      urls.push(normalizedInput);
+    }
+    for (const wellKnownPath of WELL_KNOWN_PATHS) {
+      urls.push(new URL(wellKnownPath, parsed.origin).toString());
+    }
+    return [...new Set(urls)];
+  }
+  parseIndex(value) {
+    if (!value || typeof value !== "object" || !("skills" in value) || !Array.isArray(value.skills)) {
+      return null;
+    }
+    const skills = [];
+    for (const item of value.skills) {
+      if (!item || typeof item !== "object") {
+        return null;
+      }
+      const candidate = item;
+      if (typeof candidate.name !== "string" || !candidate.name.trim()) {
+        return null;
+      }
+      if (typeof candidate.source !== "string" || !candidate.source.trim()) {
+        return null;
+      }
+      skills.push({
+        name: candidate.name.trim(),
+        source: candidate.source.trim(),
+        ...typeof candidate.description === "string" ? { description: candidate.description } : {},
+        ...typeof candidate.version === "string" ? { version: candidate.version } : {},
+        ...typeof candidate.author === "string" ? { author: candidate.author } : {}
+      });
+    }
+    return { skills };
+  }
+}
+var WELL_KNOWN_PATHS;
+var init_wellKnownDiscovery = __esm(() => {
+  init_http();
+  WELL_KNOWN_PATHS = [
+    "/.well-known/agent-skills/index.json",
+    "/.well-known/skills/index.json"
+  ];
+});
+
 // dist/core/skillsManager.js
 import {resolve as resolve9, join as join7, relative as relative4, basename as basename3, dirname as dirname4} from "path";
 import {promises as fs27} from "fs";
@@ -19201,6 +19417,9 @@ class SkillsManager {
     if (httpSource) {
       return httpSource;
     }
+    if (source.startsWith("http://") || source.startsWith("https://")) {
+      return { type: "well-known", url: source };
+    }
     const sshSource = this.parseSshRepositorySource(source);
     if (sshSource) {
       return sshSource;
@@ -19646,6 +19865,20 @@ class SkillsManager {
           cleanup
         };
       }
+      if (resolved.type === "well-known") {
+        if (!resolved.url) {
+          throw new Error(`Invalid well-known source: ${source}`);
+        }
+        const discovered = await this.loadWellKnownSkillsContext(resolved.url, projectPath);
+        return {
+          skills: discovered.skills,
+          warnings: discovered.warnings,
+          cleanup: async () => {
+            await discovered.cleanup();
+            await cleanup();
+          }
+        };
+      }
       let repoPath;
       if (resolved.type === "github" || resolved.type === "gitlab" || resolved.type === "bitbucket") {
         if (!resolved.url) {
@@ -19683,6 +19916,50 @@ class SkillsManager {
       throw error;
     }
   }
+  async loadWellKnownSkillsContext(source, projectPath) {
+    const { WellKnownDiscovery: WellKnownDiscovery2 } = await Promise.resolve().then(() => (init_wellKnownDiscovery(), exports_wellKnownDiscovery));
+    const discovery = new WellKnownDiscovery2;
+    const indexSkills = await discovery.discover(source);
+    const contexts = [];
+    const skills2 = [];
+    const warnings = [];
+    const cleanup = async () => {
+      await Promise.all(contexts.map((context) => context.cleanup().catch(() => {
+      })));
+      contexts.length = 0;
+    };
+    try {
+      for (const indexSkill of indexSkills) {
+        const nestedSource = this.resolveSource(indexSkill.source);
+        if (nestedSource.type === "well-known") {
+          warnings.push(`Skipped "${indexSkill.name}": well-known indexes cannot reference another well-known index`);
+          continue;
+        }
+        const context = await this.loadDiscoveredSkillsContext(indexSkill.source, projectPath);
+        contexts.push(context);
+        const exactMatches = context.skills.filter((skill) => skill.name.trim().toLowerCase() === indexSkill.name.trim().toLowerCase());
+        const selectedSkills = exactMatches.length > 0 ? exactMatches : context.skills.length === 1 ? context.skills : [];
+        if (selectedSkills.length === 0) {
+          warnings.push(`Skipped "${indexSkill.name}": no matching skill found at ${indexSkill.source}`);
+          continue;
+        }
+        for (const skill of selectedSkills) {
+          skills2.push({
+            ...skill,
+            name: indexSkill.name || skill.name,
+            description: indexSkill.description || skill.description,
+            source: "well-known",
+            ...indexSkill.author ? { author: indexSkill.author } : {},
+            ...indexSkill.version ? { version: indexSkill.version } : {}
+          });
+        }
+      }
+      return { skills: skills2, warnings, cleanup };
+    } catch (error) {
+      await cleanup();
+      throw error;
+    }
+  }
   async discoverFromSource(source, projectPath, options2 = {}) {
     const context = await this.loadDiscoveredSkillsContext(source, projectPath, options2);
     try {
@@ -20484,6 +20761,186 @@ var init_skillsManager = __esm(() => {
   ];
 });
 
+// dist/core/agentsMdManager.js
+var exports_agentsMdManager = {};
+__export(exports_agentsMdManager, {
+  AgentsMdManager: () => {
+    {
+      return AgentsMdManager;
+    }
+  }
+});
+import {promises as fs33} from "fs";
+import {resolve as resolve12} from "path";
+
+class AgentsMdManager {
+  projectPath;
+  constructor(projectPath) {
+    this.projectPath = projectPath;
+  }
+  getAgentsMdPath() {
+    return resolve12(this.projectPath, "AGENTS.md");
+  }
+  getClaudeMdPath() {
+    return resolve12(this.projectPath, "CLAUDE.md");
+  }
+  async read() {
+    return readFileIfExists(this.getAgentsMdPath());
+  }
+  async readAgentFile(agentFileName) {
+    return readFileIfExists(resolve12(this.projectPath, agentFileName));
+  }
+  parseSections(content) {
+    return this.parseSectionRanges(content).map(({ heading, body, level }) => ({
+      heading,
+      body,
+      level
+    }));
+  }
+  findSection(sections, heading) {
+    const normalized = heading.trim().toLowerCase();
+    return sections.find((s) => s.heading.trim().toLowerCase() === normalized);
+  }
+  async setSection(options2) {
+    const agentsMdPath = this.getAgentsMdPath();
+    const heading = this.normalizeHeadingInput(options2.heading);
+    const content = (await readFileIfExists(agentsMdPath) || "").replace(/\r\n/g, "\n");
+    const sections = this.parseSectionRanges(content);
+    const placement = this.parsePlacement(options2.placement);
+    const existing = this.findSectionRange(sections, heading);
+    let newContent;
+    if (existing) {
+      newContent = `${content.slice(0, existing.start)}${this.renderSection(existing.level, existing.heading, options2.body)}${content.slice(existing.end)}`;
+    } else {
+      const newSection = this.renderSection(2, heading, options2.body);
+      if (placement.type === "after") {
+        const after = this.findSectionRange(sections, placement.heading);
+        newContent = after ? this.insertSection(content, after.end, newSection) : this.insertSection(content, content.length, newSection);
+      } else if (placement.type === "prepend") {
+        newContent = this.insertSection(content, 0, newSection);
+      } else {
+        newContent = this.insertSection(content, content.length, newSection);
+      }
+    }
+    await writeFile(agentsMdPath, this.ensureTrailingNewline(newContent));
+  }
+  async removeSection(options2) {
+    const agentsMdPath = this.getAgentsMdPath();
+    const content = await readFileIfExists(agentsMdPath);
+    if (!content)
+      return false;
+    const normalizedContent = content.replace(/\r\n/g, "\n");
+    const section = this.findSectionRange(this.parseSectionRanges(normalizedContent), this.normalizeHeadingInput(options2.heading));
+    if (!section)
+      return false;
+    const before = normalizedContent.slice(0, section.start).trimEnd();
+    const after = normalizedContent.slice(section.end).trimStart();
+    const newContent = [before, after].filter(Boolean).join("\n");
+    await writeFile(agentsMdPath, this.ensureTrailingNewline(newContent));
+    return true;
+  }
+  async symlinkClaude() {
+    const agentsMdPath = this.getAgentsMdPath();
+    const claudeMdPath = this.getClaudeMdPath();
+    if (!await fileExists(agentsMdPath)) {
+      throw new Error("AGENTS.md does not exist. Create AGENTS.md first.");
+    }
+    try {
+      const stats = await fs33.lstat(claudeMdPath);
+      if (!stats.isSymbolicLink()) {
+        throw new Error("CLAUDE.md already exists and is not a symlink. Move or remove it before creating the alias.");
+      }
+    } catch (error) {
+      if (!this.isMissingPathError(error)) {
+        throw error;
+      }
+    }
+    const created = await createRelativeSymlink(agentsMdPath, claudeMdPath);
+    if (!created) {
+      throw new Error("Failed to create symlink from CLAUDE.md to AGENTS.md");
+    }
+  }
+  parseSectionRanges(content) {
+    const sections = [];
+    const headingPattern = /^(#{1,6})[ \t]+(.+?)\s*$/gm;
+    let match;
+    while ((match = headingPattern.exec(content)) !== null) {
+      const lineEndIndex = content.indexOf("\n", match.index);
+      sections.push({
+        heading: match[2].trim(),
+        level: match[1].length,
+        start: match.index,
+        headingEnd: lineEndIndex === -1 ? content.length : lineEndIndex + 1
+      });
+    }
+    return sections.map((section, index) => {
+      const nextPeerOrParent = sections.slice(index + 1).find((next) => next.level <= section.level);
+      const end = nextPeerOrParent?.start ?? content.length;
+      return {
+        ...section,
+        end,
+        body: content.slice(section.headingEnd, end).trimEnd()
+      };
+    });
+  }
+  findSectionRange(sections, heading) {
+    const normalized = this.normalizeHeading(heading);
+    return sections.find((s) => this.normalizeHeading(s.heading) === normalized);
+  }
+  normalizeHeadingInput(heading) {
+    const normalized = heading.trim();
+    if (!normalized || normalized.includes("\n") || normalized.includes("\r")) {
+      throw new Error("Section heading must be a single non-empty line");
+    }
+    return normalized;
+  }
+  normalizeHeading(heading) {
+    return heading.trim().toLowerCase();
+  }
+  parsePlacement(placement) {
+    if (!placement || placement === "append") {
+      return { type: "append" };
+    }
+    if (placement === "prepend") {
+      return { type: "prepend" };
+    }
+    if (placement.startsWith("after ")) {
+      return { type: "after", heading: this.normalizeHeadingInput(placement.slice(6)) };
+    }
+    throw new Error('Placement must be "append", "prepend", or "after <heading>"');
+  }
+  renderSection(level, heading, body) {
+    const normalizedBody = body.replace(/\r\n/g, "\n").trimEnd();
+    return normalizedBody ? `${"#".repeat(level)} ${heading}\n${normalizedBody}\n` : `${"#".repeat(level)} ${heading}\n`;
+  }
+  insertSection(content, index, renderedSection) {
+    const before = content.slice(0, index).trimEnd();
+    const after = content.slice(index).trimStart();
+    if (!before && !after) {
+      return renderedSection;
+    }
+    if (!before) {
+      return `${renderedSection}\n${after}`;
+    }
+    if (!after) {
+      return `${before}\n\n${renderedSection}`;
+    }
+    return `${before}\n\n${renderedSection}\n${after}`;
+  }
+  ensureTrailingNewline(content) {
+    if (!content.trim()) {
+      return "";
+    }
+    return content.endsWith("\n") ? content : `${content}\n`;
+  }
+  isMissingPathError(error) {
+    return !!error && typeof error === "object" && "code" in error && error.code === "ENOENT";
+  }
+}
+var init_agentsMdManager = __esm(() => {
+  init_fs();
+});
+
 // node_modules/ajv/lib/refs/data.json
 var require_data = __commonJS((exports, module) => {
   module.exports = {
@@ -21405,7 +21862,7 @@ var require_uri_all = __commonJS((exports, module) => {
       target.fragment = relative7.fragment;
       return target;
     }
-    function resolve14(baseURI, relativeURI, options2) {
+    function resolve15(baseURI, relativeURI, options2) {
       var schemelessOptions = assign({ scheme: "null" }, options2);
       return serialize(resolveComponents(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true), schemelessOptions);
     }
@@ -21673,7 +22130,7 @@ var require_uri_all = __commonJS((exports, module) => {
     exports2.removeDotSegments = removeDotSegments;
     exports2.serialize = serialize;
     exports2.resolveComponents = resolveComponents;
-    exports2.resolve = resolve14;
+    exports2.resolve = resolve15;
     exports2.normalize = normalize;
     exports2.equal = equal;
     exports2.escapeComponent = escapeComponent;
@@ -22036,13 +22493,13 @@ var require_json_schema_traverse = __commonJS((exports, module) => {
 
 // node_modules/ajv/lib/compile/resolve.js
 var require_resolve = __commonJS((exports, module) => {
-  var resolve14 = function(compile, root, ref) {
+  var resolve15 = function(compile, root, ref) {
     var refVal = this._refs[ref];
     if (typeof refVal == "string") {
       if (this._refs[refVal])
         refVal = this._refs[refVal];
       else
-        return resolve14.call(this, compile, root, refVal);
+        return resolve15.call(this, compile, root, refVal);
     }
     refVal = refVal || this._schemas[ref];
     if (refVal instanceof SchemaObject) {
@@ -22247,13 +22704,13 @@ var require_resolve = __commonJS((exports, module) => {
   var util6 = require_util3();
   var SchemaObject = require_schema_obj();
   var traverse = require_json_schema_traverse();
-  module.exports = resolve14;
-  resolve14.normalizeId = normalizeId;
-  resolve14.fullPath = getFullPath;
-  resolve14.url = resolveUrl;
-  resolve14.ids = resolveIds;
-  resolve14.inlineRef = inlineRef;
-  resolve14.schema = resolveSchema;
+  module.exports = resolve15;
+  resolve15.normalizeId = normalizeId;
+  resolve15.fullPath = getFullPath;
+  resolve15.url = resolveUrl;
+  resolve15.ids = resolveIds;
+  resolve15.inlineRef = inlineRef;
+  resolve15.schema = resolveSchema;
   var PREVENT_SCOPE_CHANGE = util6.toHash(["properties", "patternProperties", "enum", "dependencies", "definitions"]);
   var SIMPLE_INLINED = util6.toHash([
     "type",
@@ -22284,15 +22741,15 @@ var require_error_classes = __commonJS((exports, module) => {
   };
   var MissingRefError = function(baseId, ref, message) {
     this.message = message || MissingRefError.message(baseId, ref);
-    this.missingRef = resolve14.url(baseId, ref);
-    this.missingSchema = resolve14.normalizeId(resolve14.fullPath(this.missingRef));
+    this.missingRef = resolve15.url(baseId, ref);
+    this.missingSchema = resolve15.normalizeId(resolve15.fullPath(this.missingRef));
   };
   var errorSubclass = function(Subclass) {
     Subclass.prototype = Object.create(Error.prototype);
     Subclass.prototype.constructor = Subclass;
     return Subclass;
   };
-  var resolve14 = require_resolve();
+  var resolve15 = require_resolve();
   module.exports = {
     Validation: errorSubclass(ValidationError),
     MissingRef: errorSubclass(MissingRefError)
@@ -22886,7 +23343,7 @@ var require_compile = __commonJS((exports, module) => {
         RULES,
         validate: validateGenerator,
         util: util6,
-        resolve: resolve14,
+        resolve: resolve15,
         resolveRef,
         usePattern,
         useDefault,
@@ -22925,7 +23382,7 @@ var require_compile = __commonJS((exports, module) => {
       return validate2;
     }
     function resolveRef(baseId2, ref, isRoot) {
-      ref = resolve14.url(baseId2, ref);
+      ref = resolve15.url(baseId2, ref);
       var refIndex = refs[ref];
       var _refVal, refCode;
       if (refIndex !== undefined) {
@@ -22942,11 +23399,11 @@ var require_compile = __commonJS((exports, module) => {
         }
       }
       refCode = addLocalRef(ref);
-      var v2 = resolve14.call(self, localCompile, root, ref);
+      var v2 = resolve15.call(self, localCompile, root, ref);
       if (v2 === undefined) {
         var localSchema = localRefs && localRefs[ref];
         if (localSchema) {
-          v2 = resolve14.inlineRef(localSchema, opts.inlineRefs) ? localSchema : compile.call(self, localSchema, root, localRefs, baseId2);
+          v2 = resolve15.inlineRef(localSchema, opts.inlineRefs) ? localSchema : compile.call(self, localSchema, root, localRefs, baseId2);
         }
       }
       if (v2 === undefined) {
@@ -23088,7 +23545,7 @@ var require_compile = __commonJS((exports, module) => {
       code += statement(i, arr);
     return code;
   };
-  var resolve14 = require_resolve();
+  var resolve15 = require_resolve();
   var util6 = require_util3();
   var errorClasses = require_error_classes();
   var stableStringify = require_fast_json_stable_stringify();
@@ -26337,7 +26794,7 @@ var require_ajv = __commonJS((exports, module) => {
     var id = this._getId(schema2);
     if (id !== undefined && typeof id != "string")
       throw new Error("schema id must be string");
-    key = resolve14.normalizeId(key || id);
+    key = resolve15.normalizeId(key || id);
     checkUnique(this, key);
     this._schemas[key] = this._addSchema(schema2, _skipValidation, _meta, true);
     return this;
@@ -26383,7 +26840,7 @@ var require_ajv = __commonJS((exports, module) => {
     }
   };
   var _getSchemaFragment = function(self, ref) {
-    var res = resolve14.schema.call(self, { schema: {} }, ref);
+    var res = resolve15.schema.call(self, { schema: {} }, ref);
     if (res) {
       var { schema: schema2, root, baseId } = res;
       var v = compileSchema.call(self, schema2, root, undefined, baseId);
@@ -26399,7 +26856,7 @@ var require_ajv = __commonJS((exports, module) => {
     }
   };
   var _getSchemaObj = function(self, keyRef) {
-    keyRef = resolve14.normalizeId(keyRef);
+    keyRef = resolve15.normalizeId(keyRef);
     return self._schemas[keyRef] || self._refs[keyRef] || self._fragments[keyRef];
   };
   var removeSchema = function(schemaKeyRef) {
@@ -26427,7 +26884,7 @@ var require_ajv = __commonJS((exports, module) => {
         this._cache.del(cacheKey);
         var id = this._getId(schemaKeyRef);
         if (id) {
-          id = resolve14.normalizeId(id);
+          id = resolve15.normalizeId(id);
           delete this._schemas[id];
           delete this._refs[id];
         }
@@ -26452,14 +26909,14 @@ var require_ajv = __commonJS((exports, module) => {
     if (cached)
       return cached;
     shouldAddSchema = shouldAddSchema || this._opts.addUsedSchema !== false;
-    var id = resolve14.normalizeId(this._getId(schema2));
+    var id = resolve15.normalizeId(this._getId(schema2));
     if (id && shouldAddSchema)
       checkUnique(this, id);
     var willValidate = this._opts.validateSchema !== false && !skipValidation;
     var recursiveMeta;
-    if (willValidate && !(recursiveMeta = id && id == resolve14.normalizeId(schema2.$schema)))
+    if (willValidate && !(recursiveMeta = id && id == resolve15.normalizeId(schema2.$schema)))
       this.validateSchema(schema2, true);
-    var localRefs = resolve14.ids.call(this, schema2);
+    var localRefs = resolve15.ids.call(this, schema2);
     var schemaObj = new SchemaObject({
       id,
       schema: schema2,
@@ -26620,7 +27077,7 @@ var require_ajv = __commonJS((exports, module) => {
   var noop = function() {
   };
   var compileSchema = require_compile();
-  var resolve14 = require_resolve();
+  var resolve15 = require_resolve();
   var Cache = require_cache();
   var SchemaObject = require_schema_obj();
   var stableStringify = require_fast_json_stable_stringify();
@@ -26681,27 +27138,27 @@ var require_windows = __commonJS((exports, module) => {
     return checkPathExt(path, options2);
   };
   var isexe = function(path, options2, cb) {
-    fs34.stat(path, function(er, stat) {
+    fs36.stat(path, function(er, stat) {
       cb(er, er ? false : checkStat(stat, path, options2));
     });
   };
   var sync = function(path, options2) {
-    return checkStat(fs34.statSync(path), path, options2);
+    return checkStat(fs36.statSync(path), path, options2);
   };
   module.exports = isexe;
   isexe.sync = sync;
-  var fs34 = __require("fs");
+  var fs36 = __require("fs");
 });
 
 // node_modules/isexe/mode.js
 var require_mode = __commonJS((exports, module) => {
   var isexe = function(path, options2, cb) {
-    fs34.stat(path, function(er, stat) {
+    fs36.stat(path, function(er, stat) {
       cb(er, er ? false : checkStat(stat, options2));
     });
   };
   var sync = function(path, options2) {
-    return checkStat(fs34.statSync(path), options2);
+    return checkStat(fs36.statSync(path), options2);
   };
   var checkStat = function(stat, options2) {
     return stat.isFile() && checkMode(stat, options2);
@@ -26721,7 +27178,7 @@ var require_mode = __commonJS((exports, module) => {
   };
   module.exports = isexe;
   isexe.sync = sync;
-  var fs34 = __require("fs");
+  var fs36 = __require("fs");
 });
 
 // node_modules/isexe/index.js
@@ -26735,12 +27192,12 @@ var require_isexe = __commonJS((exports, module) => {
       if (typeof Promise !== "function") {
         throw new TypeError("callback not provided");
       }
-      return new Promise(function(resolve14, reject) {
+      return new Promise(function(resolve15, reject) {
         isexe(path, options2 || {}, function(er, is) {
           if (er) {
             reject(er);
           } else {
-            resolve14(is);
+            resolve15(is);
           }
         });
       });
@@ -26766,7 +27223,7 @@ var require_isexe = __commonJS((exports, module) => {
       }
     }
   };
-  var fs34 = __require("fs");
+  var fs36 = __require("fs");
   var core2;
   if (process.platform === "win32" || global.TESTING_WINDOWS) {
     core2 = require_windows();
@@ -26811,27 +27268,27 @@ var require_which = __commonJS((exports, module) => {
       opt = {};
     const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt);
     const found = [];
-    const step = (i) => new Promise((resolve14, reject) => {
+    const step = (i) => new Promise((resolve15, reject) => {
       if (i === pathEnv.length)
-        return opt.all && found.length ? resolve14(found) : reject(getNotFoundError(cmd));
+        return opt.all && found.length ? resolve15(found) : reject(getNotFoundError(cmd));
       const ppRaw = pathEnv[i];
       const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
       const pCmd = path.join(pathPart, cmd);
       const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
-      resolve14(subStep(p, i, 0));
+      resolve15(subStep(p, i, 0));
     });
-    const subStep = (p, i, ii) => new Promise((resolve14, reject) => {
+    const subStep = (p, i, ii) => new Promise((resolve15, reject) => {
       if (ii === pathExt.length)
-        return resolve14(step(i + 1));
+        return resolve15(step(i + 1));
       const ext = pathExt[ii];
       isexe(p + ext, { pathExt: pathExtExe }, (er, is) => {
         if (!er && is) {
           if (opt.all)
             found.push(p + ext);
           else
-            return resolve14(p + ext);
+            return resolve15(p + ext);
         }
-        return resolve14(subStep(p, i, ii + 1));
+        return resolve15(subStep(p, i, ii + 1));
       });
     });
     return cb ? step(0).then((res) => cb(null, res), cb) : step(0);
@@ -26973,14 +27430,14 @@ var require_readShebang = __commonJS((exports, module) => {
     const buffer = Buffer.alloc(size);
     let fd;
     try {
-      fd = fs34.openSync(command, "r");
-      fs34.readSync(fd, buffer, 0, size, 0);
-      fs34.closeSync(fd);
+      fd = fs36.openSync(command, "r");
+      fs36.readSync(fd, buffer, 0, size, 0);
+      fs36.closeSync(fd);
     } catch (e) {
     }
     return shebangCommand(buffer.toString());
   };
-  var fs34 = __require("fs");
+  var fs36 = __require("fs");
   var shebangCommand = require_shebang_command();
   module.exports = readShebang;
 });
@@ -32412,6 +32869,16 @@ async function syncCommand(options2) {
         if (options2.backup && result.changes.some((c) => c.action === "backed_up")) {
           logger.info("\uD83D\uDCBE Backup files created with .agentinit.backup extension");
         }
+        if (options2.symlink) {
+          const { AgentsMdManager: AgentsMdManager2 } = await Promise.resolve().then(() => (init_agentsMdManager(), exports_agentsMdManager));
+          const mdManager = new AgentsMdManager2(cwd);
+          try {
+            await mdManager.symlinkClaude();
+            logger.info("\uD83D\uDD17 CLAUDE.md symlinked to AGENTS.md");
+          } catch (error) {
+            logger.warning(`Failed to create symlink: ${error instanceof Error ? error.message : "Unknown error"}`);
+          }
+        }
       }
     } else {
       spinner.fail("Synchronization failed");
@@ -32702,14 +33169,14 @@ class MCPParser {
 
 // dist/utils/ownPackageVersion.js
 import {readFileSync as readFileSync2} from "node:fs";
-import {dirname as dirname6, resolve as resolve12} from "node:path";
+import {dirname as dirname6, resolve as resolve13} from "node:path";
 import {fileURLToPath} from "node:url";
 function getOwnPackageVersion(fallback2 = "0.0.0") {
   const moduleDir = dirname6(fileURLToPath(import.meta.url));
   const candidates = [
-    resolve12(moduleDir, "../package.json"),
-    resolve12(moduleDir, "../../package.json"),
-    resolve12(process.cwd(), "package.json")
+    resolve13(moduleDir, "../package.json"),
+    resolve13(moduleDir, "../../package.json"),
+    resolve13(process.cwd(), "package.json")
   ];
   for (const packageJsonPath of candidates) {
     try {
@@ -32748,7 +33215,7 @@ import {readFileSync as readFileSync4} from "fs";
 
 // dist/core/rulesTemplateLoader.js
 var toml = __toESM(require_toml(), 1);
-import {resolve as resolve13, dirname as dirname7} from "path";
+import {resolve as resolve14, dirname as dirname7} from "path";
 import {fileURLToPath as fileURLToPath2} from "url";
 import {readFileSync as readFileSync3, readdirSync, existsSync as existsSync2} from "fs";
 var __filename2 = fileURLToPath2(import.meta.url);
@@ -32758,7 +33225,7 @@ class RulesTemplateLoader {
   templatesPath;
   templates = new Map;
   constructor() {
-    this.templatesPath = resolve13(__dirname2, "../templates/rules");
+    this.templatesPath = resolve14(__dirname2, "../templates/rules");
     this.loadTemplates();
   }
   loadTemplates() {
@@ -32768,7 +33235,7 @@ class RulesTemplateLoader {
     const files = readdirSync(this.templatesPath).filter((file) => file.endsWith(".toml"));
     for (const file of files) {
       try {
-        const filePath = resolve13(this.templatesPath, file);
+        const filePath = resolve14(this.templatesPath, file);
         const content = readFileSync3(filePath, "utf-8");
         const parsed = toml.default.parse(content);
         const template = {
@@ -38340,7 +38807,7 @@ class Protocol {
   }
   request(request, resultSchema, options2) {
     const { relatedRequestId, resumptionToken, onresumptiontoken } = options2 !== null && options2 !== undefined ? options2 : {};
-    return new Promise((resolve14, reject) => {
+    return new Promise((resolve15, reject) => {
       var _a, _b, _c, _d, _e, _f;
       if (!this._transport) {
         reject(new Error("Not connected"));
@@ -38391,7 +38858,7 @@ class Protocol {
         }
         try {
           const result = resultSchema.parse(response.result);
-          resolve14(result);
+          resolve15(result);
         } catch (error) {
           reject(error);
         }
@@ -38771,7 +39238,7 @@ class StdioClientTransport {
     if (this._process) {
       throw new Error("StdioClientTransport already started! If using Client class, note that connect() calls start() automatically.");
     }
-    return new Promise((resolve14, reject) => {
+    return new Promise((resolve15, reject) => {
       var _a, _b, _c, _d, _e;
       this._process = import_cross_spawn.default(this._serverParams.command, (_a = this._serverParams.args) !== null && _a !== undefined ? _a : [], {
         env: {
@@ -38794,7 +39261,7 @@ class StdioClientTransport {
         (_b2 = this.onerror) === null || _b2 === undefined || _b2.call(this, error);
       });
       this._process.on("spawn", () => {
-        resolve14();
+        resolve15();
       });
       this._process.on("close", (_code) => {
         var _a2;
@@ -38849,16 +39316,16 @@ class StdioClientTransport {
     this._readBuffer.clear();
   }
   send(message) {
-    return new Promise((resolve14) => {
+    return new Promise((resolve15) => {
       var _a;
       if (!((_a = this._process) === null || _a === undefined ? undefined : _a.stdin)) {
         throw new Error("Not connected");
       }
       const json2 = serializeMessage(message);
       if (this._process.stdin.write(json2)) {
-        resolve14();
+        resolve15();
       } else {
-        this._process.stdin.once("drain", resolve14);
+        this._process.stdin.once("drain", resolve15);
       }
     });
   }
@@ -40280,7 +40747,7 @@ class SSEClientTransport {
   _startOrAuth() {
     var _a, _b, _c;
     const fetchImpl = (_c = (_b = (_a = this === null || this === undefined ? undefined : this._eventSourceInit) === null || _a === undefined ? undefined : _a.fetch) !== null && _b !== undefined ? _b : this._fetch) !== null && _c !== undefined ? _c : fetch;
-    return new Promise((resolve14, reject) => {
+    return new Promise((resolve15, reject) => {
       this._eventSource = new EventSource(this._url.href, {
         ...this._eventSourceInit,
         fetch: async (url, init2) => {
@@ -40300,7 +40767,7 @@ class SSEClientTransport {
       this._eventSource.onerror = (event) => {
         var _a2;
         if (event.code === 401 && this._authProvider) {
-          this._authThenStart().then(resolve14, reject);
+          this._authThenStart().then(resolve15, reject);
           return;
         }
         const error = new SseError(event.code, event.message, event);
@@ -40323,7 +40790,7 @@ class SSEClientTransport {
           this.close();
           return;
         }
-        resolve14();
+        resolve15();
       });
       this._eventSource.onmessage = (event) => {
         var _a2, _b2;
@@ -40990,7 +41457,7 @@ class MCPVerifier {
 }
 
 // dist/core/gitignoreManager.js
-import {promises as fs34} from "fs";
+import {promises as fs36} from "fs";
 import {dirname as dirname8, join as join9} from "path";
 var normalizeIgnorePath = function(projectPath, value) {
   const relative7 = value.startsWith(projectPath) ? value.slice(projectPath.length + 1) : value;
@@ -41043,7 +41510,7 @@ async function updateManagedIgnoreFile(projectPath, paths6, options2 = {}) {
   if (options2.local) {
     const gitDir = join9(projectPath, ".git");
     try {
-      const stat = await fs34.stat(gitDir);
+      const stat = await fs36.stat(gitDir);
       if (!stat.isDirectory()) {
         throw new Error;
       }
@@ -41054,13 +41521,13 @@ async function updateManagedIgnoreFile(projectPath, paths6, options2 = {}) {
   const normalizedPaths = [...new Set(paths6.map((path) => normalizeIgnorePath(projectPath, path)).filter(Boolean))].sort();
   let existingContent = "";
   try {
-    existingContent = await fs34.readFile(ignoreFilePath, "utf8");
+    existingContent = await fs36.readFile(ignoreFilePath, "utf8");
   } catch {
     existingContent = "";
   }
   const updatedContent = updateManagedBlock(existingContent, normalizedPaths);
-  await fs34.mkdir(dirname8(ignoreFilePath), { recursive: true });
-  await fs34.writeFile(ignoreFilePath, updatedContent, "utf8");
+  await fs36.mkdir(dirname8(ignoreFilePath), { recursive: true });
+  await fs36.writeFile(ignoreFilePath, updatedContent, "utf8");
   return ignoreFilePath;
 }
 async function removeManagedIgnoreBlock(projectPath, options2 = {}) {
@@ -41068,7 +41535,7 @@ async function removeManagedIgnoreBlock(projectPath, options2 = {}) {
   const ignoreFilePath = join9(projectPath, ignoreFile);
   let content;
   try {
-    content = await fs34.readFile(ignoreFilePath, "utf8");
+    content = await fs36.readFile(ignoreFilePath, "utf8");
   } catch {
     return false;
   }
@@ -41084,13 +41551,13 @@ async function removeManagedIgnoreBlock(projectPath, options2 = {}) {
   const afterBlock = content.slice(endIndex + END_MARKER.length).replace(/^\n+/, "");
   let nextContent = `${beforeBlock}${afterBlock}`.replace(/\n{3,}/g, "\n\n").replace(/^\n+/, "");
   if (nextContent.trim() === "") {
-    await fs34.rm(ignoreFilePath, { force: true }).catch(() => {
+    await fs36.rm(ignoreFilePath, { force: true }).catch(() => {
     });
   } else {
     if (!nextContent.endsWith("\n")) {
       nextContent += "\n";
     }
-    await fs34.writeFile(ignoreFilePath, nextContent, "utf8");
+    await fs36.writeFile(ignoreFilePath, nextContent, "utf8");
   }
   return true;
 }
@@ -42238,7 +42705,7 @@ var import_prompts3 = __toESM(require_prompts3(), 1);
 init_colors();
 init_logger();
 import {homedir as homedir7} from "os";
-import {relative as relative8, resolve as resolve14} from "path";
+import {relative as relative8, resolve as resolve15} from "path";
 
 // dist/utils/promptUtils.js
 var import_prompts2 = __toESM(require_prompts3(), 1);
@@ -42703,6 +43170,35 @@ function registerSkillsCommand(program2) {
       }
     }
   });
+  skills3.command("discover <url>").description("Discover skills from a well-known endpoint or URL").action(async (url, options2) => {
+    logger.titleBox("AgentInit  Skills Discovery");
+    const spinner = ora(`Discovering skills from ${url}...`).start();
+    try {
+      const projectPath = process.cwd();
+      const agentManager9 = new AgentManager;
+      const skillsManager5 = new SkillsManager(agentManager9);
+      const result = await skillsManager5.discoverFromSource(url, projectPath);
+      spinner.stop();
+      if (result.skills.length === 0) {
+        logger.info("No skills discovered.");
+        return;
+      }
+      for (const skill of result.skills) {
+        logger.info(`  ${green(skill.name)}${skill.version ? ` @ ${skill.version}` : ""}`);
+        if (skill.description) {
+          logger.info(`    ${skill.description}`);
+        }
+        if (skill.author) {
+          logger.info(`    Author: ${skill.author}`);
+        }
+      }
+      logger.info(`\nTotal: ${result.skills.length} skill(s)`);
+    } catch (error) {
+      spinner.fail("Discovery failed");
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
   skills3.command("list").alias("ls").description("List installed skills").option("-g, --global", "List only global skills").option("-a, --agent <agents...>", "Filter by specific agent(s)").action(async (options2) => {
     logger.titleBox("AgentInit  Skills");
     const agentManager9 = new AgentManager;
@@ -42875,7 +43371,7 @@ Dry run \u2014 no changes made.`));
         const entries = await installLock3.getCurrentState({
           kind: "skill",
           name,
-          projectPath: resolve14(cwd),
+          projectPath: resolve15(cwd),
           scope: "project"
         });
         if (entries.length === 0) {
@@ -42931,7 +43427,7 @@ Dry run \u2014 no changes made.`));
       } else {
         const entries = await installLock3.getCurrentState({
           kind: "skill",
-          projectPath: resolve14(cwd),
+          projectPath: resolve15(cwd),
           scope: "project"
         });
         if (entries.length === 0) {
@@ -43136,7 +43632,7 @@ var buildSkillGroups = function(agents, projectPath, global3) {
     dirToAgents.set(skillsDir, existing);
   }
   return Array.from(dirToAgents.entries()).map(([dir, groupedAgents]) => {
-    const canonicalShared = resolve14(dir) === getCanonicalSkillsDirForScope(projectPath, !!global3) && groupedAgents.every((agent) => agent.getProjectSkillsStandard() === "agents");
+    const canonicalShared = resolve15(dir) === getCanonicalSkillsDirForScope(projectPath, !!global3) && groupedAgents.every((agent) => agent.getProjectSkillsStandard() === "agents");
     return {
       dir,
       displayDir: formatSkillsDir(projectPath, dir),
@@ -43159,7 +43655,7 @@ var prependCanonicalGlobalGroup = function(agentManager9, projectPath, groups) {
   if (sharedAgents.length === 0) {
     return groups;
   }
-  const existingCanonicalIndex = groups.findIndex((group) => resolve14(group.dir) === canonicalDir);
+  const existingCanonicalIndex = groups.findIndex((group) => resolve15(group.dir) === canonicalDir);
   if (existingCanonicalIndex >= 0) {
     const existingCanonical = groups[existingCanonicalIndex];
     const remaining = groups.filter((_, index) => index !== existingCanonicalIndex);
@@ -43216,10 +43712,10 @@ var formatPromptPath = function(path) {
   return normalizedPath;
 };
 var getCanonicalGlobalSkillsDir = function() {
-  return resolve14(homedir7(), ".agents/skills");
+  return resolve15(homedir7(), ".agents/skills");
 };
 var getCanonicalSkillsDirForScope = function(projectPath, global3) {
-  return global3 ? getCanonicalGlobalSkillsDir() : resolve14(projectPath, ".agents/skills");
+  return global3 ? getCanonicalGlobalSkillsDir() : resolve15(projectPath, ".agents/skills");
 };
 var getCanonicalGlobalSkillsDisplayPath = function() {
   return formatPromptPath(getCanonicalGlobalSkillsDir());
@@ -44348,7 +44844,7 @@ function registerRulesCommand(program2) {
 // dist/commands/plugins.js
 var import_prompts4 = __toESM(require_prompts3(), 1);
 import {homedir as homedir8} from "os";
-import {dirname as dirname10, relative as relative9, resolve as resolve15} from "path";
+import {dirname as dirname10, relative as relative9, resolve as resolve16} from "path";
 init_logger();
 init_pluginManager();
 init_agentManager();
@@ -44969,7 +45465,7 @@ var buildGlobalPluginGroups = function(agentManager12, projectPath) {
     compatibleAgentNames: [],
     kind: "native"
   }));
-  const canonicalDir = resolve15(homedir8(), ".agents/skills");
+  const canonicalDir = resolve16(homedir8(), ".agents/skills");
   const sharedAgents = agentManager12.getAllAgents().filter((agent) => agent.supportsSkills() && agent.getProjectSkillsStandard() === "agents" && !!agent.getSkillsDir(projectPath, true));
   const claudeGroups = nativeGroups.filter((group) => group.agents.some((agent) => agent.id === "claude"));
   const otherGroups = nativeGroups.filter((group) => !group.agents.some((agent) => agent.id === "claude"));
@@ -45083,7 +45579,7 @@ async function interactiveAgentSelect(pluginManager3, agentManager12, projectPat
 init_colors();
 init_logger();
 init_installLock();
-import {resolve as resolve16} from "path";
+import {resolve as resolve17} from "path";
 var formatTimestamp = function(iso) {
   const date = new Date(iso);
   return date.toLocaleDateString("en-US", {
@@ -45113,7 +45609,7 @@ function registerLockCommand(program2) {
     if (options2.kind)
       queryOptions.kind = options2.kind;
     if (options2.project)
-      queryOptions.projectPath = resolve16(options2.project);
+      queryOptions.projectPath = resolve17(options2.project);
     if (options2.agent)
       queryOptions.agent = options2.agent;
     if (options2.scope)
@@ -46814,6 +47310,134 @@ function registerAgentCommand(program2) {
   });
 }
 
+// dist/commands/agentsMd.js
+init_colors();
+init_logger();
+init_agentsMdManager();
+function registerAgentsMdCommand(program2) {
+  const agentsMd = program2.command("agents-md").description("Manage AGENTS.md and per-agent rule files");
+  agentsMd.command("init").description("Initialize AGENTS.md if it does not exist").action(async () => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    const spinner = ora("Checking AGENTS.md...").start();
+    try {
+      const content = await manager.read();
+      if (content) {
+        spinner.succeed("AGENTS.md already exists");
+        return;
+      }
+      await manager.setSection({
+        heading: "Project Overview",
+        body: "Add your project context here."
+      });
+      spinner.succeed("Created AGENTS.md");
+    } catch (error) {
+      spinner.fail("Failed to initialize AGENTS.md");
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+  agentsMd.command("set-section").description("Add or update a section in AGENTS.md").argument("<heading>", "Section heading").option("-b, --body <body>", "Section body text", "").option("-f, --file <path>", "Read body from file").option("--placement <placement>", 'Placement: append, prepend, or "after <heading>"', "append").action(async (heading, options2) => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    const spinner = ora(`Updating section "${heading}"...`).start();
+    try {
+      let body = options2.body;
+      if (options2.file) {
+        const { readFileIfExists: readFileIfExists2 } = await Promise.resolve().then(() => (init_fs(), exports_fs));
+        const fileContent = await readFileIfExists2(options2.file);
+        if (!fileContent) {
+          spinner.fail(`File not found: ${options2.file}`);
+          process.exit(1);
+        }
+        body = fileContent;
+      }
+      await manager.setSection({
+        heading,
+        body,
+        placement: options2.placement
+      });
+      spinner.succeed(`Updated section "${heading}" in AGENTS.md`);
+    } catch (error) {
+      spinner.fail(`Failed to update section "${heading}"`);
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+  agentsMd.command("remove-section").description("Remove a section from AGENTS.md").argument("<heading>", "Section heading to remove").action(async (heading) => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    const spinner = ora(`Removing section "${heading}"...`).start();
+    try {
+      const removed = await manager.removeSection({ heading });
+      if (removed) {
+        spinner.succeed(`Removed section "${heading}"`);
+      } else {
+        spinner.warn(`Section "${heading}" not found`);
+      }
+    } catch (error) {
+      spinner.fail(`Failed to remove section "${heading}"`);
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+  agentsMd.command("read").description("Read AGENTS.md content").action(async () => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    try {
+      const content = await manager.read();
+      if (!content) {
+        logger.info("AGENTS.md does not exist");
+        return;
+      }
+      logger.info(content);
+    } catch (error) {
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+  agentsMd.command("symlink-claude").description("Create CLAUDE.md symlink pointing to AGENTS.md").action(async () => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    const spinner = ora("Creating CLAUDE.md -> AGENTS.md symlink...").start();
+    try {
+      await manager.symlinkClaude();
+      spinner.succeed("CLAUDE.md now symlinks to AGENTS.md");
+    } catch (error) {
+      spinner.fail("Failed to create symlink");
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+  agentsMd.command("parse").description("Parse and list AGENTS.md sections").action(async () => {
+    const projectPath = process.cwd();
+    const manager = new AgentsMdManager(projectPath);
+    try {
+      const content = await manager.read();
+      if (!content) {
+        logger.info("AGENTS.md does not exist");
+        return;
+      }
+      const sections = manager.parseSections(content);
+      if (sections.length === 0) {
+        logger.info("No sections found in AGENTS.md");
+        return;
+      }
+      for (const section of sections) {
+        logger.info(`${"#".repeat(section.level)} ${green(section.heading)}`);
+        const bodyPreview = section.body.split("\n").slice(0, 3).join("\n");
+        if (bodyPreview) {
+          logger.info(bodyPreview);
+        }
+        logger.info("");
+      }
+    } catch (error) {
+      logger.error(`Error: ${error instanceof Error ? error.message : "Unknown error"}`);
+      process.exit(1);
+    }
+  });
+}
+
 // dist/cli.js
 init_logger();
 var program2 = new Command;
@@ -46825,9 +47449,10 @@ registerPluginsCommand(program2);
 registerConfigCommand(program2);
 registerLockCommand(program2);
 registerAgentCommand(program2);
+registerAgentsMdCommand(program2);
 program2.command("init").description("Initialize agents.md configuration for the current project").option("-f, --force", "Overwrite existing configuration").option("-t, --template <template>", "Use specific template (web, cli, library)").action(initCommand);
 program2.command("detect").description("Detect current project stack and existing agent configurations").option("-v, --verbose", "Show detailed detection results").action(detectCommand);
-program2.command("sync").description("Sync agents.md with agent-specific configuration files").option("-a, --agent <agents...>", "Target specific agent(s)").option("-d, --dry-run", "Show what would be changed without making changes").option("-b, --backup", "Create backup before syncing").action(syncCommand);
+program2.command("sync").description("Sync agents.md with agent-specific configuration files").option("-a, --agent <agents...>", "Target specific agent(s)").option("-d, --dry-run", "Show what would be changed without making changes").option("-b, --backup", "Create backup before syncing").option("--symlink", "Create CLAUDE.md symlink to AGENTS.md after sync").action(syncCommand);
 program2.command("apply").description("Apply agents.md and project-owned skills to supported agent files").option("-a, --agent <agents...>", "Target specific agent(s)").option("-d, --dry-run", "Preview changes without writing files").option("-b, --backup", "Create sibling .agentinit.backup files before overwriting").option("--no-skills", "Disable project-owned skills propagation").option("--copy-skills", "Copy project-owned skills instead of using canonical symlink installs").option("--no-gitignore", "Disable managed ignore block updates").option("--gitignore-local", "Write ignore entries to .git/info/exclude instead of .gitignore").allowUnknownOption(true).action(async (options2, command) => {
   const rawArgs = command.parent.rawArgs.slice(3);
   if (hasLegacyApplyArgs(rawArgs)) {