@googlarz/agents-sync 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 googlarz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,366 @@
+# agents-sync
+
+**Write your AI context once. Stay in sync everywhere.**
+
+`agents-sync` reads your codebase, generates a canonical `AGENTS.md`, and automatically derives tool-specific files for every AI coding tool you use — Claude Code, Cursor, GitHub Copilot, and more.
+
+One source of truth. No more manually maintaining five config files that are always out of sync.
+
+---
+
+## The Problem
+
+Every AI coding tool expects its own context file:
+
+| Tool | File |
+|---|---|
+| Claude Code | `CLAUDE.md` |
+| Cursor | `.cursorrules` |
+| GitHub Copilot | `.github/copilot-instructions.md` |
+| Codex / Amp | `AGENTS.md` |
+| Gemini CLI | `GEMINI.md` |
+| Windsurf | `.windsurfrules` |
+| Cline | `.clinerules` |
+
+If you use more than one tool — and most teams do — you're maintaining these manually. They drift. Conventions you updated in `CLAUDE.md` are still wrong in `.cursorrules`. Your new database is still Postgres in Copilot's mind. A new engineer using Cursor gets guidance that contradicts what Claude Code users know.
+
+This is [GitHub issue #6235](https://github.com/anthropics/claude-code/issues/6235) — **AGENTS.md portability**, **3,914 upvotes**, the most demanded feature in the Claude Code repo. `agents-sync` solves it.
+
+---
+
+## How It Works
+
+```
+Your codebase
+     │
+     ▼
+[scan]  manifests · directory tree · source samples · README · FIXME/HACK comments
+     │
+     ▼
+[extract]  Claude API → structured project metadata (stack, conventions, gotchas, boundaries)
+     │
+     ▼
+[generate]  canonical AGENTS.md  ←─── one source of truth
+     │
+     ├──▶  CLAUDE.md          (superset + Claude Code-specific additions)
+     ├──▶  .cursorrules       (directive-style, < 400 words)
+     ├──▶  .github/copilot-instructions.md  (code-level focus, < 300 words)
+     ├──▶  GEMINI.md          (full AGENTS.md + Gemini CLI section)
+     ├──▶  .windsurfrules     (directive-style, < 400 words)
+     └──▶  .clinerules        (Always/Never sections, < 400 words)
+```
+
+---
+
+## Install
+
+```bash
+# No global install needed — use npx
+npx @googlarz/agents-sync --help
+
+# Or install globally
+npm install -g @googlarz/agents-sync
+```
+
+---
+
+## Setup
+
+### Claude Code
+
+Add to `~/.claude/claude_desktop_config.json` or your project's `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "agents-sync": {
+      "command": "npx",
+      "args": ["@googlarz/agents-sync"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+Restart Claude Code. Then use the `/agents-sync` skill.
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project:
+
+```json
+{
+  "mcpServers": {
+    "agents-sync": {
+      "command": "npx",
+      "args": ["@googlarz/agents-sync"],
+      "env": {
+        "ANTHROPIC_API_KEY": "sk-ant-..."
+      }
+    }
+  }
+}
+```
+
+---
+
+## Usage
+
+### First run
+
+```
+/agents-sync init
+```
+
+```
+✓ AGENTS.md → /your/project/AGENTS.md
+✓ AGENTS.md → /your/project/AGENTS.md
+✓ claude → /your/project/CLAUDE.md
+✓ cursor → /your/project/.cursorrules
+✓ copilot → /your/project/.github/copilot-instructions.md
+✓ gemini → /your/project/GEMINI.md
+✓ windsurf → /your/project/.windsurfrules
+✓ cline → /your/project/.clinerules
+
+✓ Snapshot saved to .agents-sync/
+  → Add AGENTS.md to git. Add .agents-sync/ to .gitignore.
+```
+
+### Check for drift
+
+```
+/agents-sync drift
+```
+
+```
+agents-sync drift report (2026-05-20)
+Last sync: 12 days ago
+
+HIGH  New dependency detected: drizzle-orm
+      (package.json changed — possible architecture shift)
+HIGH  New top-level directory: src/workers/
+
+MED   3 new files with new naming pattern
+
+Recommendation: Re-sync recommended. Run /agents-sync sync.
+```
+
+### Re-sync
+
+```
+/agents-sync sync
+```
+
+```
+✓ claude → /your/project/CLAUDE.md
+✓ cursor → /your/project/.cursorrules
+✓ copilot → /your/project/.github/copilot-instructions.md
+
+  2 custom section(s) preserved
+```
+
+### Validate files are in sync
+
+```
+/agents-sync validate
+```
+
+```
+AGENTS.md (canonical)  ✓
+
+✓ claude      in sync   /your/project/CLAUDE.md
+⚠ cursor      DRIFTED   /your/project/.cursorrules
+              File was modified after last sync
+✓ copilot     in sync   /your/project/.github/copilot-instructions.md
+
+Some files are out of sync. Run /agents-sync sync to fix.
+```
+
+### Standalone CLI
+
+agents-sync also works as a standalone CLI without an MCP host:
+
+```bash
+# Initialize a project
+npx @googlarz/agents-sync init .
+
+# Check drift
+npx @googlarz/agents-sync drift .
+
+# Re-sync
+npx @googlarz/agents-sync sync .
+
+# Validate all files
+npx @googlarz/agents-sync validate .
+
+# Re-derive a single tool file (no Claude API call)
+npx @googlarz/agents-sync export cursor .
+
+# CI mode — exit 1 when drift is HIGH
+npx @googlarz/agents-sync drift . --ci
+```
+
+---
+
+## GitHub Action
+
+Keep context files in sync automatically. Copy [`docs/github-action.yml`](docs/github-action.yml) to `.github/workflows/agents-sync.yml` in your repo, then add `ANTHROPIC_API_KEY` to repository secrets.
+
+The workflow:
+- Runs every Monday at 9am UTC
+- Triggers on `package.json` / `pyproject.toml` / `Cargo.toml` / `go.mod` changes
+- Checks drift; when drift is HIGH, re-syncs and opens a PR
+
+---
+
+## Sample Output
+
+### Generated AGENTS.md (abbreviated)
+
+```markdown
+# AGENTS.md
+
+<!-- Generated by agents-sync v1.0.0 on 2026-05-20 -->
+
+## Project Overview
+Acme Dashboard is an internal analytics tool for the sales team, built with
+Next.js 14 App Router, PostgreSQL via Prisma, and NextAuth.
+
+## Tech Stack
+- TypeScript / Next.js 14 (App Router)
+- PostgreSQL via Prisma ORM
+- Authentication: NextAuth v4
+- Testing: Vitest (co-located)
+- Deploy: Vercel
+
+## Architecture
+- `src/app/` — Next.js pages and layouts (App Router)
+- `src/features/` — feature modules (dashboard, users, reports)
+- `src/lib/` — shared utilities: db singleton, auth config, api client
+- `src/components/` — shared UI components
+
+## Conventions
+1. kebab-case filenames throughout
+2. Named exports only — no default exports except Next.js page/layout components
+3. All external input validated with Zod before use
+4. Co-locate tests: `Button.test.tsx` next to `Button.tsx`
+
+## Gotchas
+1. Never import `PrismaClient` directly — use `lib/db.ts` singleton. Direct imports
+   cause connection pool exhaustion in Vercel's serverless runtime.
+2. All API routes require auth middleware. Check `middleware.ts` before adding routes.
+
+## Boundaries
+
+### Never
+- Commit `.env` or `.env.local`
+- Instantiate `PrismaClient` outside of `lib/db.ts`
+- Use `any` type — use `unknown` and narrow
+```
+
+### Derived `.cursorrules` (abbreviated)
+
+```
+# .cursorrules — managed by agents-sync
+# Language: TypeScript / Next.js 14
+
+- Always: use kebab-case filenames
+- Always: named exports only (no default exports except page/layout components)
+- Always: validate external input with Zod
+- Always: co-locate tests (*.test.ts next to source)
+- Never: import PrismaClient directly (use lib/db.ts — pool exhaustion risk)
+- Never: add API routes without auth middleware (check middleware.ts)
+- Never: commit .env or .env.local
+- Never: use `any` type
+- Tests: `npm test`
+```
+
+---
+
+## Custom Sections
+
+Add permanent, sync-safe customizations to any managed file:
+
+```markdown
+<!-- AGENTS-SYNC:CUSTOM:START -->
+When working on the payments module, check with @alice before shipping.
+Use staging Stripe keys (in .env.staging) for all local testing.
+<!-- AGENTS-SYNC:CUSTOM:END -->
+```
+
+These blocks survive every `/agents-sync sync`. Edit them freely.
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `ANTHROPIC_API_KEY` | Yes (for init/sync) | Your Anthropic API key |
+| `AGENTS_SYNC_DEBUG=1` | No | Verbose debug output to stderr |
+| `NO_COLOR=1` | No | Disable ANSI color in output |
+
+---
+
+## MCP Tools Reference
+
+agents-sync exposes 6 MCP tools directly:
+
+| Tool | Description |
+|---|---|
+| `agents_sync_init` | Full init: scan, extract, generate, derive, snapshot |
+| `agents_sync_sync` | Re-sync from current codebase state |
+| `agents_sync_drift` | Check what changed since last sync (read-only) |
+| `agents_sync_export` | Re-derive a single tool file |
+| `agents_sync_validate` | Check if all tool files match AGENTS.md |
+| `agents_sync_status` | Show sync status and managed files |
+
+---
+
+## Supported Stacks
+
+Tested on:
+
+- **TypeScript/JavaScript**: Next.js, Express, Fastify, Remix, SvelteKit
+- **Python**: Django, FastAPI, Flask
+- **Rust**: Cargo workspaces, Axum, Actix
+- **Go**: standard modules, Gin, Echo
+- **PHP**: Composer projects, Laravel
+
+Language-agnostic analysis — works on any codebase with a manifest file.
+
+---
+
+## How Is This Different From [agents-sync on npm]?
+
+The existing `agents-sync` package (v0.2.0) is a file watcher that mirrors format changes between static files. It has no AI component.
+
+This package **reads and understands your codebase using Claude**, then generates content from scratch — conventions, gotchas, architecture descriptions — specific to your project. It's not a format converter. It's an analyst.
+
+---
+
+## Contributing
+
+Issues and PRs welcome. The codebase is straightforward TypeScript:
+
+```bash
+git clone https://github.com/googlarz/agents-sync
+cd agents-sync
+npm install
+npm run dev      # watch mode
+npm test         # unit tests
+```
+
+Integration tests require `ANTHROPIC_API_KEY` and run against real fixtures:
+
+```bash
+npm run test:integration
+```
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+/**
+ * agents-sync CLI
+ *
+ * Usage:
+ *   npx @googlarz/agents-sync                  Start MCP server (default)
+ *   npx @googlarz/agents-sync init [path]      Generate all context files
+ *   npx @googlarz/agents-sync sync [path]      Re-sync after codebase changes
+ *   npx @googlarz/agents-sync drift [path]     Check what changed
+ *   npx @googlarz/agents-sync validate [path]  Check files are in sync
+ *   npx @googlarz/agents-sync status [path]    Show sync status
+ *   npx @googlarz/agents-sync export <tool> [path]  Re-derive a single file
+ */
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import fs from "node:fs";
+import process from "node:process";
+import { isAgentsSyncError } from "./lib/errors.js";
+const args = process.argv.slice(2);
+const cwd = process.cwd();
+// ---------------------------------------------------------------------------
+// Flags
+// ---------------------------------------------------------------------------
+function hasFlag(...flags) {
+    return flags.some((f) => args.includes(f));
+}
+function removeFlags(argv) {
+    return argv.filter((a) => !a.startsWith("--") && !a.startsWith("-"));
+}
+// ---------------------------------------------------------------------------
+// --version / --help
+// ---------------------------------------------------------------------------
+if (hasFlag("--version", "-v")) {
+    const pkgPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    process.stdout.write(`@googlarz/agents-sync v${pkg.version}\n`);
+    process.exit(0);
+}
+if (hasFlag("--help", "-h")) {
+    process.stdout.write(`
+agents-sync — AI context file generator and syncer
+
+USAGE
+  agents-sync [command] [path] [options]
+
+COMMANDS
+  init [path]               Analyze codebase, generate all context files
+  sync [path]               Re-sync after codebase changes
+  drift [path]              Check what changed since last sync
+  validate [path]           Check if all files match AGENTS.md
+  status [path]             Show sync status and managed files
+  export <tool> [path]      Re-derive a single tool file (no API call)
+                            Tools: claude, cursor, copilot, gemini, windsurf, cline
+
+  (no command)              Start MCP server (stdio transport)
+
+OPTIONS
+  --dry-run                 Preview changes without writing files
+  --fast                    sync only — skip API call if drift is minor
+  --ci                      drift only — exit 1 when drift is HIGH (for CI)
+  --tools <list>            Comma-separated tools to generate (init/sync)
+                            e.g. --tools claude,cursor,copilot
+  --repomix-output <file>   Use repomix XML/text output as source corpus
+                            (init/sync) instead of filesystem sampling
+  --version, -v             Print version
+  --help, -h                Show this help
+
+EXAMPLES
+  npx @googlarz/agents-sync init .
+  npx @googlarz/agents-sync sync . --fast
+  npx @googlarz/agents-sync drift . --ci
+  npx @googlarz/agents-sync export cursor .
+
+SETUP (MCP — Claude Code)
+  Add to ~/.claude/claude_desktop_config.json or .claude/settings.json:
+
+  {
+    "mcpServers": {
+      "agents-sync": {
+        "command": "npx",
+        "args": ["@googlarz/agents-sync"],
+        "env": { "ANTHROPIC_API_KEY": "sk-ant-..." }
+      }
+    }
+  }
+
+ENVIRONMENT
+  ANTHROPIC_API_KEY     Required for init and sync
+  AGENTS_SYNC_DEBUG=1   Verbose debug output to stderr
+  NO_COLOR=1            Disable ANSI color
+
+`);
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// CLI subcommand dispatch
+// ---------------------------------------------------------------------------
+const positional = removeFlags(args);
+const subcommand = positional[0];
+const dryRun = hasFlag("--dry-run");
+const fast = hasFlag("--fast");
+const ci = hasFlag("--ci");
+function resolvePath(pos) {
+    return pos ? path.resolve(pos) : cwd;
+}
+function getTools() {
+    const idx = args.indexOf("--tools");
+    if (idx === -1)
+        return undefined;
+    const val = args[idx + 1];
+    return val ? val.split(",").map((t) => t.trim()) : undefined;
+}
+function getFlag(name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    return args[idx + 1];
+}
+function die(msg) {
+    process.stderr.write(`agents-sync error: ${msg}\n`);
+    process.exit(1);
+}
+function printResult(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + "\n");
+}
+async function runCli() {
+    switch (subcommand) {
+        case "init": {
+            const { runInit } = await import("./tools/init.js");
+            const projectPath = resolvePath(positional[1]);
+            const tools = getTools();
+            const repomixOutput = getFlag("--repomix-output");
+            const result = await runInit({ projectPath, tools, dryRun, repomixOutput });
+            if (result.dryRun) {
+                process.stdout.write(`Dry run — no files written.\n`);
+                process.stdout.write(`Would generate:\n`);
+                process.stdout.write(`  AGENTS.md\n`);
+            }
+            else {
+                process.stdout.write(`✓ AGENTS.md → ${result.agentsMdPath}\n`);
+                for (const f of result.filesWritten) {
+                    process.stdout.write(`✓ ${f.tool} → ${f.path}\n`);
+                }
+                if (result.preservedExistingFiles.length > 0) {
+                    process.stdout.write(`\n⚠ Preserved pre-existing files as custom sections:\n`);
+                    for (const f of result.preservedExistingFiles) {
+                        process.stdout.write(`  ${f}\n`);
+                    }
+                }
+            }
+            for (const w of result.warnings) {
+                process.stdout.write(`  → ${w}\n`);
+            }
+            break;
+        }
+        case "sync": {
+            const { runSync } = await import("./tools/sync.js");
+            const projectPath = resolvePath(positional[1]);
+            const tools = getTools();
+            const repomixOutput = getFlag("--repomix-output");
+            const result = await runSync({ projectPath, tools, fast, dryRun, repomixOutput });
+            for (const f of result.filesUpdated) {
+                process.stdout.write(`✓ ${f.tool} → ${f.path}\n`);
+            }
+            for (const w of result.warnings) {
+                process.stdout.write(`  → ${w}\n`);
+            }
+            break;
+        }
+        case "drift": {
+            const { runDrift } = await import("./tools/drift.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runDrift({ projectPath });
+            process.stdout.write(result.report + "\n");
+            if (ci && result.highDrift) {
+                process.exit(1);
+            }
+            break;
+        }
+        case "validate": {
+            const { runValidate } = await import("./tools/validate.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runValidate({ projectPath });
+            process.stdout.write(result.report + "\n");
+            if (!result.allInSync)
+                process.exit(1);
+            break;
+        }
+        case "status": {
+            const { runStatus } = await import("./tools/status.js");
+            const projectPath = resolvePath(positional[1]);
+            const result = await runStatus({ projectPath });
+            printResult(result);
+            break;
+        }
+        case "export": {
+            const { runExport } = await import("./tools/export.js");
+            const tool = positional[1];
+            const projectPath = resolvePath(positional[2]);
+            if (!tool)
+                die("export requires a tool name: claude, cursor, copilot, gemini, windsurf, cline");
+            const result = await runExport({ projectPath, tool: tool });
+            process.stdout.write(result.report + "\n");
+            break;
+        }
+        case undefined:
+        case "--mcp": {
+            // Default: start MCP server
+            await import("./server.js");
+            break;
+        }
+        default:
+            die(`unknown command: ${subcommand}. Run --help for usage.`);
+    }
+}
+runCli().catch((err) => {
+    if (isAgentsSyncError(err) && err.code === "MISSING_API_KEY") {
+        process.stderr.write([
+            "",
+            "  agents-sync: ANTHROPIC_API_KEY not set",
+            "",
+            "  The init and sync commands call Claude to analyze your codebase.",
+            "  These commands do NOT need an API key:",
+            "    agents-sync drift     agents-sync validate",
+            "    agents-sync status    agents-sync export",
+            "",
+            "  Get a key at: https://console.anthropic.com/",
+            "  Then set it:  export ANTHROPIC_API_KEY=sk-ant-...",
+            "",
+        ].join("\n"));
+        process.exit(1);
+    }
+    const msg = isAgentsSyncError(err) ? err.format() : err instanceof Error ? err.message : String(err);
+    process.stderr.write(`agents-sync error: ${msg}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config/loader.d.ts

@@ -0,0 +1,9 @@
+import { type AgentsSyncConfig } from "./schema.js";
+import type { ProjectMetadata } from "../extractor/schema.js";
+export declare function loadConfig(projectPath: string): Promise<AgentsSyncConfig | null>;
+/**
+ * Merge config-defined conventions and boundaries into extracted metadata.
+ * Config items are appended after Claude-extracted ones so they survive re-sync.
+ */
+export declare function applyConfig(metadata: ProjectMetadata, config: AgentsSyncConfig | null): ProjectMetadata;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA0BtF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,eAAe,CAevG"}