@sayansr26/agent-os 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project are documented here.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.1] — 2026-09-15
+
+Found by running 0.5.0 against a real repository that already had six
+path-scoped rules and a hand-written `AGENTS.md`. It overwrote the
+`AGENTS.md`. 0.5.0 was never published.
+
+### Added
+- **`init` installs the Claude Code plugin.** When Claude Code is detected it
+  runs `claude plugin marketplace add` and `claude plugin install --yes` at
+  project scope, so the plugin travels with the repository rather than living
+  on one machine. If the `claude` CLI is not on PATH it prints the two slash
+  commands instead. `--no-plugin` skips it, and the rules are written either
+  way — the compiler never depends on the plugin step succeeding.
+
+### Fixed
+- **`init` scaffolded over projects that already had rules.** It wrote a
+  placeholder `AGENTS.md` and an `example.md` rule regardless of what was
+  there, and the next `sync` compiled the placeholder on top of the project's
+  real `AGENTS.md`. `init` now adopts what it finds — the existing `AGENTS.md`
+  and the first rules directory it recognises, `.cursor/rules/*.mdc` converted
+  back to `paths:` — and seeds `example.md` only when there was nothing to
+  adopt. A tool for stopping rule drift must not cause it.
+- **`sync` now refuses to overwrite a file it did not generate.** Generated
+  files carry a banner; anything else at a generated path is the user's own
+  work. `sync` names those files, leaves them alone and exits non-zero, with
+  `--force` as the explicit opt-out. `AGENTS.md` carries the banner too — it
+  previously did not, which is why nothing could tell it apart.
+
 ## [0.5.0] — 2026-09-15
 
 `agent-os` becomes a cross-tool CLI. The Claude Code plugin is now one target
@@ -40,18 +68,6 @@ among several rather than the whole product.
 - Documentation is generic throughout; examples are invented.
 
 ### Fixed
-- **`init` scaffolded over projects that already had rules.** It wrote a
-  placeholder `AGENTS.md` and an `example.md` rule regardless of what was
-  there, and the next `sync` compiled the placeholder on top of the project's
-  real `AGENTS.md`. `init` now adopts what it finds — the existing `AGENTS.md`
-  and the first rules directory it recognises, `.cursor/rules/*.mdc` converted
-  back to `paths:` — and seeds `example.md` only when there was nothing to
-  adopt. A tool for stopping rule drift must not cause it.
-- **`sync` now refuses to overwrite a file it did not generate.** Generated
-  files carry a banner; anything else at a generated path is the user's own
-  work. `sync` names those files, leaves them alone and exits non-zero, with
-  `--force` as the explicit opt-out. `AGENTS.md` carries the banner too — it
-  previously did not, which is why nothing could tell it apart.
 - `check` reported every skill file as drifted immediately after a `sync`. Skill
   files are read as buffers so a skill can ship a binary asset, rule files are
   generated as strings, and the two were compared with `!==`. Comparison is now

package/README.md

@@ -76,6 +76,13 @@ Every command below is `npx @sayansr26/agent-os <command>`. Install it once —
 
 `--root <dir>` to target another directory, `--dry-run` to preview.
 
+**`init` sets up Claude Code completely.** When it detects Claude Code it also
+installs the plugin — the agents, skills, per-agent memory and session hook —
+with `claude plugin marketplace add` and `claude plugin install --yes` at
+project scope, so it travels with the repo. `--no-plugin` skips it. Every other
+detected tool gets its rules in its own schema; the plugin layer is Claude Code
+only because no other tool has anywhere to put it.
+
 **On an existing project, `init` adopts rather than scaffolds.** It takes your
 current `AGENTS.md` and the first rules directory it recognises as the source,
 so the first `sync` regenerates what you already had. **`sync` never overwrites

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayansr26/agent-os",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "One source of truth for AI coding agent config. Write your rules once; compile them to Claude Code, Cursor, Cline, Windsurf, Antigravity, Gemini CLI, OpenCode and Kilo.",
   "keywords": [
     "ai",

package/src/cli.mjs

@@ -5,6 +5,7 @@ import { join } from "node:path";
 import { detect, summarise, TOOLS } from "./detect.mjs";
 import { load, write, readIfExists, matches, BANNER, DIR } from "./source.mjs";
 import { adopt } from "./adopt.mjs";
+import { installPlugin, MARKETPLACE, MARKETPLACE_NAME, PLUGIN } from "./plugin.mjs";
 import { compile, TARGETS } from "./targets.mjs";
 
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
@@ -27,6 +28,7 @@ Options
   --root <dir>   project directory (default: cwd)
   --dry-run      print what would change, write nothing
   --force        overwrite files agent-os did not generate (it refuses by default)
+  --no-plugin    skip installing the Claude Code plugin during init
 `;
 
 function scaffold(root, found) {
@@ -203,7 +205,25 @@ Pick one:
       return;
     }
 
-    console.log(`\n${dim("Generated files carry a banner. Edit .agent-os/ and re-run sync; never edit them directly.")}\n`);
+    console.log(`\n${dim("Generated files carry a banner. Edit .agent-os/ and re-run sync; never edit them directly.")}`);
+
+    // The rules are done and safe at this point. The Claude Code plugin is the
+    // other half — agents, skills, per-agent memory, the session hook — and it
+    // installs from the same repo. Only on `init`, never on `sync`.
+    if (cmd === "init" && targets.includes("claude-code") && !argv.includes("--no-plugin")) {
+      console.log(`\n${bold("Claude Code plugin")} ${dim(`${PLUGIN}@${MARKETPLACE_NAME}`)}\n`);
+      const r = installPlugin({ dry });
+      for (const line of r.done) console.log(`  ${dim(line)}`);
+      if (r.ok && r.reason === "installed") {
+        console.log(`\n  installed at project scope ${dim("— .claude/settings.json, so it travels with the repo")}`);
+        console.log(`  ${dim("restart Claude Code, or /reload-plugins, then run /agent-os:init")}`);
+      } else if (!r.ok) {
+        console.log("");
+        for (const line of r.hint) console.log(`  ${line}`);
+      }
+      console.log(`\n  ${dim("--no-plugin skips this")}`);
+    }
+    console.log("");
     return;
   }
 

package/src/plugin.mjs

@@ -0,0 +1,74 @@
+/**
+ * Install the Claude Code half of agent-os during `init`.
+ *
+ * The CLI compiles rules for every tool. Claude Code additionally gets the
+ * agents, skills, per-agent memory and session hook, which ship as a plugin —
+ * so `init` should install it rather than printing two slash commands and
+ * hoping. `claude plugin ...` with `--yes` is the documented automation path.
+ *
+ * Everything here is best effort and reversible: if the `claude` CLI is not on
+ * PATH, or a command fails, `init` reports it and carries on. The rules are the
+ * part that must not depend on this.
+ */
+import { spawnSync } from "node:child_process";
+
+export const MARKETPLACE = "sayansr26/agent-os";
+export const MARKETPLACE_NAME = "sayan-plugins";
+export const PLUGIN = "agent-os";
+
+const run = (args) =>
+  spawnSync("claude", args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+
+/** Is the Claude Code CLI usable from here? */
+export function claudeAvailable() {
+  const r = spawnSync("claude", ["--version"], { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] });
+  return !r.error && r.status === 0;
+}
+
+/**
+ * Add the marketplace and install the plugin at project scope, so the setup
+ * travels with the repository instead of living on one machine.
+ */
+export function installPlugin({ dry = false, scope = "project" } = {}) {
+  const steps = [
+    ["marketplace", ["plugin", "marketplace", "add", MARKETPLACE, "--scope", scope]],
+    ["plugin", ["plugin", "install", `${PLUGIN}@${MARKETPLACE_NAME}`, "--scope", scope, "--yes"]],
+  ];
+
+  if (!claudeAvailable())
+    return {
+      ok: false,
+      reason: "no-cli",
+      done: [],
+      hint: [
+        "The `claude` CLI is not on PATH, so the plugin was not installed.",
+        "Inside Claude Code, run:",
+        `  /plugin marketplace add ${MARKETPLACE}`,
+        `  /plugin install ${PLUGIN}@${MARKETPLACE_NAME}`,
+      ],
+    };
+
+  if (dry)
+    return { ok: true, reason: "dry-run", done: steps.map(([, a]) => `claude ${a.join(" ")}`), hint: [] };
+
+  const done = [];
+  for (const [what, args] of steps) {
+    const r = run(args);
+    if (r.status !== 0) {
+      const err = (r.stderr || r.stdout || "").trim().split("\n").slice(-3).join("\n");
+      return {
+        ok: false,
+        reason: what,
+        done,
+        hint: [
+          `\`claude ${args.join(" ")}\` failed:`,
+          ...err.split("\n").map((l) => `  ${l}`),
+          "The rules above were still written. Install the plugin by hand inside",
+          `Claude Code: /plugin install ${PLUGIN}@${MARKETPLACE_NAME}`,
+        ],
+      };
+    }
+    done.push(`claude ${args.join(" ")}`);
+  }
+  return { ok: true, reason: "installed", done, hint: [] };
+}

package/src/selftest.mjs

@@ -77,7 +77,7 @@ try {
     writeFileSync(join(r2, ".claude/rules/theming.md"),
       '---\ndescription: Theming\npaths:\n  - "src/**/*.tsx"\n---\n\nUse the token set.\n');
 
-    const i = cli(["init"], r2);
+    const i = cli(["init", "--no-plugin"], r2);
     ok(i.status === 0, "init exits 0 on a project that already has rules");
     ok(readFileSync(join(r2, "AGENTS.md"), "utf8") === realAgents ||
        readFileSync(join(r2, ".agent-os/AGENTS.md"), "utf8") === realAgents,
@@ -85,6 +85,16 @@ try {
     ok(existsSync(join(r2, ".agent-os/rules/theming.md")), "existing .claude/rules/ are adopted");
     ok(!existsSync(join(r2, ".agent-os/rules/example.md")), "no example.md when real rules were adopted");
     ok(!existsSync(join(r2, ".claude/rules/example.md")), "no example.md compiled into the project");
+    ok(!i.stdout.includes("Claude Code plugin"), "--no-plugin skips the plugin install");
+
+    // init offers the plugin when not told otherwise; --dry-run proves the
+    // commands without running them against the machine's real config.
+    const r4 = mkdtempSync(join(tmpdir(), "agent-os-plug-"));
+    const pi = cli(["init", "--dry-run"], r4);
+    ok(pi.stdout.includes("Claude Code plugin"), "init sets up the Claude Code plugin by default");
+    ok(/marketplace add sayansr26\/agent-os|plugin marketplace add|not on PATH/.test(pi.stdout),
+       "init names the marketplace step or says why it could not run it");
+    rmSync(r4, { recursive: true, force: true });
 
     // A hand-written file at a generated path must survive a sync.
     const r3 = mkdtempSync(join(tmpdir(), "agent-os-guard-"));