@aman_asmuei/aman-agent 0.33.8 → 0.34.0

package/README.md

@@ -121,11 +121,13 @@ $ aman-agent dev ~/projects/amantrade
 
 | Flag | What it does |
 |:---|:---|
-| `--smart` | Use your configured LLM to synthesize a smarter CLAUDE.md |
-| `--yolo` | Launch Claude Code with `--dangerously-skip-permissions` (full autonomous mode) |
-| `--no-launch` | Generate CLAUDE.md only, don't start Claude Code |
+| `--smart` | Use your configured LLM to synthesize a smarter context file |
+| `--yolo` | Launch with skip-permissions (Claude Code only) |
+| `--copilot` | Target GitHub Copilot — writes `.github/copilot-instructions.md`, opens VS Code |
+| `--cursor` | Target Cursor — writes `.cursorrules`, opens Cursor |
+| `--no-launch` | Generate context file only, don't launch editor |
 | `--diff` | Preview what would change without writing |
-| `--force` | Regenerate even if CLAUDE.md is fresh |
+| `--force` | Regenerate even if context file is fresh |
 
 Works with **multiple projects** simultaneously — each terminal gets its own `aman-agent dev`, all sharing the same memory database. Decisions from one project flow into the next.
 
@@ -407,14 +409,22 @@ aman-agent dev --smart
 
 The LLM merges related corrections into single convention statements and removes redundancy. Falls back to template mode automatically if the LLM call fails.
 
-**Yolo mode** — Full autonomous, no permission prompts:
+**Multi-editor support** — Same memory, any editor:
 
 ```bash
-aman-agent dev --yolo          # skip permissions
-aman-agent dev --yolo --smart  # skip permissions + LLM-generated CLAUDE.md
+aman-agent dev                 # Claude Code (default) → CLAUDE.md
+aman-agent dev --copilot       # VS Code + Copilot → .github/copilot-instructions.md
+aman-agent dev --cursor        # Cursor → .cursorrules
 ```
 
-Launches Claude Code with `--dangerously-skip-permissions`. Use when you trust the project and want zero friction.
+All three use the same pipeline: stack detection → amem recall → context assembly. Only the output file and launcher differ.
+
+**Yolo mode** — Full autonomous, no permission prompts (Claude Code only):
+
+```bash
+aman-agent dev --yolo          # skip permissions
+aman-agent dev --yolo --smart  # skip permissions + LLM-generated context
+```
 
 **Multi-project workflow** — Each terminal is independent:
 
@@ -1367,7 +1377,7 @@ sequenceDiagram
 | Command | Description |
 |:---|:---|
 | `aman-agent` | Start interactive chat session |
-| `aman-agent dev [path]` | Scan project, generate CLAUDE.md, launch Claude Code `[--smart\|--yolo\|--no-launch\|--force\|--diff]` |
+| `aman-agent dev [path]` | Scan project, generate context, launch editor `[--smart\|--yolo\|--copilot\|--cursor\|--no-launch\|--force\|--diff]` |
 | `aman-agent init` | Set up your AI companion with a guided wizard |
 | `aman-agent serve` | Run as a local MCP server for agent delegation `[--name\|--profile]` |
 | `aman-agent setup` | Full reconfiguration wizard |

package/dist/index.js

@@ -975,6 +975,15 @@ var init_context_builder = __esm({
 });
 
 // src/dev/claude-md-writer.ts
+var claude_md_writer_exports = {};
+__export(claude_md_writer_exports, {
+  EDITOR_TARGETS: () => EDITOR_TARGETS,
+  checkStaleness: () => checkStaleness,
+  parseMarker: () => parseMarker,
+  renderToString: () => renderToString,
+  writeClaudeMd: () => writeClaudeMd,
+  writeContextFile: () => writeContextFile
+});
 import fs26 from "fs";
 import path26 from "path";
 function formatStack(stack) {
@@ -1058,36 +1067,71 @@ function parseMarker(content) {
     mode: match[3]
   };
 }
-function checkStaleness(projectPath) {
-  const claudeMdPath = path26.join(projectPath, "CLAUDE.md");
-  if (!fs26.existsSync(claudeMdPath)) {
+function checkStaleness(projectPath, editor = "claude") {
+  const target = EDITOR_TARGETS[editor];
+  const filePath = path26.join(projectPath, target.contextFile);
+  if (!fs26.existsSync(filePath)) {
     return { status: "missing" };
   }
-  const content = fs26.readFileSync(claudeMdPath, "utf-8");
+  const content = fs26.readFileSync(filePath, "utf-8");
   const marker = parseMarker(content);
   if (!marker) {
     return { status: "no-marker" };
   }
   return { status: "fresh", generatedAt: marker.generatedAt };
 }
-function writeClaudeMd(ctx, projectPath) {
-  const claudeMdPath = path26.join(projectPath, "CLAUDE.md");
+function writeContextFile(ctx, projectPath, editor = "claude") {
+  const target = EDITOR_TARGETS[editor];
+  const filePath = path26.join(projectPath, target.contextFile);
   let backedUp = false;
-  if (fs26.existsSync(claudeMdPath)) {
-    const content = fs26.readFileSync(claudeMdPath, "utf-8");
+  const parentDir = path26.dirname(filePath);
+  if (!fs26.existsSync(parentDir)) {
+    fs26.mkdirSync(parentDir, { recursive: true });
+  }
+  if (fs26.existsSync(filePath)) {
+    const content = fs26.readFileSync(filePath, "utf-8");
     const marker = parseMarker(content);
     if (!marker) {
-      fs26.copyFileSync(claudeMdPath, `${claudeMdPath}.bak`);
+      fs26.copyFileSync(filePath, `${filePath}.bak`);
       backedUp = true;
     }
   }
   const md = renderToString(ctx);
-  fs26.writeFileSync(claudeMdPath, md, "utf-8");
-  return { written: true, backedUp, path: claudeMdPath };
+  fs26.writeFileSync(filePath, md, "utf-8");
+  return { written: true, backedUp, path: filePath };
 }
+var EDITOR_TARGETS, writeClaudeMd;
 var init_claude_md_writer = __esm({
   "src/dev/claude-md-writer.ts"() {
     "use strict";
+    EDITOR_TARGETS = {
+      claude: {
+        name: "claude",
+        contextFile: "CLAUDE.md",
+        launchCmd: "claude",
+        launchArgs: [],
+        yoloArgs: ["--dangerously-skip-permissions"],
+        gitignoreEntry: "CLAUDE.md",
+        displayName: "Claude Code"
+      },
+      copilot: {
+        name: "copilot",
+        contextFile: ".github/copilot-instructions.md",
+        launchCmd: "code",
+        launchArgs: ["."],
+        gitignoreEntry: ".github/copilot-instructions.md",
+        displayName: "VS Code (Copilot)"
+      },
+      cursor: {
+        name: "cursor",
+        contextFile: ".cursorrules",
+        launchCmd: "cursor",
+        launchArgs: ["."],
+        gitignoreEntry: ".cursorrules",
+        displayName: "Cursor"
+      }
+    };
+    writeClaudeMd = writeContextFile;
   }
 });
 
@@ -1098,15 +1142,20 @@ __export(dev_command_exports, {
 });
 import fs27 from "fs";
 import path27 from "path";
-function ensureGitignore(projectPath) {
+function ensureGitignore(projectPath, editor) {
   const gitignorePath = path27.join(projectPath, ".gitignore");
   if (!fs27.existsSync(gitignorePath)) return;
   const content = fs27.readFileSync(gitignorePath, "utf-8");
-  if (content.includes("CLAUDE.md")) return;
-  fs27.appendFileSync(gitignorePath, "\n# Generated by aman-agent dev\nCLAUDE.md\n");
+  const target = EDITOR_TARGETS[editor];
+  if (content.includes(target.gitignoreEntry)) return;
+  fs27.appendFileSync(gitignorePath, `
+# Generated by aman-agent dev
+${target.gitignoreEntry}
+`);
 }
 async function runDev(projectPath, flags = {}, precomputedStack) {
   const resolved = path27.resolve(projectPath);
+  const editor = flags.editor ?? "claude";
   if (!fs27.existsSync(resolved)) {
     return { success: false, generated: false, error: `Directory not found: ${resolved}` };
   }
@@ -1114,7 +1163,8 @@ async function runDev(projectPath, flags = {}, precomputedStack) {
   if (flags.diff) {
     const ctx2 = await buildContext2(stack, { smart: flags.smart });
     const newContent = renderToString(ctx2);
-    const existingPath = path27.join(resolved, "CLAUDE.md");
+    const target = EDITOR_TARGETS[editor];
+    const existingPath = path27.join(resolved, target.contextFile);
     const existing = fs27.existsSync(existingPath) ? fs27.readFileSync(existingPath, "utf-8") : "";
     return {
       success: true,
@@ -1123,18 +1173,26 @@ async function runDev(projectPath, flags = {}, precomputedStack) {
       context: ctx2
     };
   }
-  if (!flags.force) {
-    const staleness = checkStaleness(resolved);
+  if (!flags.force && !flags.smart) {
+    const staleness = checkStaleness(resolved, editor);
     if (staleness.status === "fresh") {
-      return { success: true, generated: false, skippedReason: "fresh" };
+      if (staleness.generatedAt) {
+        const ageMs = Date.now() - staleness.generatedAt.getTime();
+        const ONE_HOUR = 60 * 60 * 1e3;
+        if (ageMs < ONE_HOUR) {
+          return { success: true, generated: false, skippedReason: "fresh" };
+        }
+      } else {
+        return { success: true, generated: false, skippedReason: "fresh" };
+      }
     }
   }
   const ctx = await buildContext2(stack, { smart: flags.smart });
-  const writeResult = writeClaudeMd(ctx, resolved);
-  ensureGitignore(resolved);
+  writeContextFile(ctx, resolved, editor);
+  ensureGitignore(resolved, editor);
   return {
     success: true,
-    generated: writeResult.written,
+    generated: true,
     context: ctx
   };
 }
@@ -7099,7 +7157,7 @@ function handleReset(action) {
 function handleUpdate() {
   try {
     const current = execFileSync3("npm", ["view", "@aman_asmuei/aman-agent", "version"], { encoding: "utf-8" }).trim();
-    const local = true ? "0.33.8" : "unknown";
+    const local = true ? "0.34.0" : "unknown";
     if (current === local) {
       return { handled: true, output: `${pc6.green("Up to date")} \u2014 v${local}` };
     }
@@ -10083,7 +10141,7 @@ var Inbox = class {
 // package.json
 var package_default = {
   name: "@aman_asmuei/aman-agent",
-  version: "0.33.8",
+  version: "0.34.0",
   description: "Your AI companion, running locally \u2014 powered by the aman ecosystem",
   type: "module",
   engines: {
@@ -10450,7 +10508,7 @@ function bootstrapEcosystem() {
   return true;
 }
 var program = new Command();
-program.name("aman-agent").description("Your AI companion, running locally").version("0.33.8").option("--model <model>", "Override LLM model").option("--budget <tokens>", "Token budget for system prompt (default: 8000)", parseInt).option("--profile <name>", "Use a specific agent profile (e.g., coder, writer, researcher)").action(async (options) => {
+program.name("aman-agent").description("Your AI companion, running locally").version("0.34.0").option("--model <model>", "Override LLM model").option("--budget <tokens>", "Token budget for system prompt (default: 8000)", parseInt).option("--profile <name>", "Use a specific agent profile (e.g., coder, writer, researcher)").action(async (options) => {
   p4.intro(pc9.bold("aman agent") + pc9.dim(" \u2014 your AI companion"));
   let config = loadConfig();
   if (!config) {
@@ -10845,9 +10903,12 @@ program.command("serve").description("Run aman-agent as a local MCP server other
     process.exit(1);
   }
 });
-program.command("dev [path]").description("Set up project context and start Claude Code").option("--smart", "Use LLM to generate CLAUDE.md").option("--no-launch", "Generate CLAUDE.md only, don't start claude").option("--force", "Regenerate even if CLAUDE.md is fresh").option("--diff", "Show what would change without writing").option("--yolo", "Launch Claude Code with --dangerously-skip-permissions").action(async (projectPath, opts) => {
+program.command("dev [path]").description("Set up project context and launch your editor (Claude Code, Copilot, or Cursor)").option("--smart", "Use LLM to synthesize context file").option("--no-launch", "Generate context file only, don't launch editor").option("--force", "Regenerate even if context file is fresh").option("--diff", "Show what would change without writing").option("--yolo", "Launch with skip-permissions (Claude Code only)").option("--copilot", "Target GitHub Copilot (writes .github/copilot-instructions.md, opens VS Code)").option("--cursor", "Target Cursor editor (writes .cursorrules, opens Cursor)").action(async (projectPath, opts) => {
   const { runDev: runDev2 } = await Promise.resolve().then(() => (init_dev_command(), dev_command_exports));
   const { scanStack: scanStack2 } = await Promise.resolve().then(() => (init_stack_detector(), stack_detector_exports));
+  const { EDITOR_TARGETS: EDITOR_TARGETS2 } = await Promise.resolve().then(() => (init_claude_md_writer(), claude_md_writer_exports));
+  const editorName = opts.copilot ? "copilot" : opts.cursor ? "cursor" : "claude";
+  const target = EDITOR_TARGETS2[editorName];
   const targetPath = projectPath ?? process.cwd();
   const stack = scanStack2(targetPath);
   const stackParts = stack.languages.map((l) => l.charAt(0).toUpperCase() + l.slice(1));
@@ -10865,13 +10926,14 @@ program.command("dev [path]").description("Set up project context and start Clau
   ${pc9.cyan("Detected:")} ${stackParts.join(" + ")}`);
   } else {
     console.log(`
-  ${pc9.dim("No stack detected \u2014 generating minimal CLAUDE.md")}`);
+  ${pc9.dim("No stack detected \u2014 generating minimal context")}`);
   }
   const result = await runDev2(targetPath, {
     smart: opts.smart,
     noLaunch: opts.launch === false,
     force: opts.force,
-    diff: opts.diff
+    diff: opts.diff,
+    editor: editorName
   }, stack);
   if (!result.success) {
     console.error(`  ${pc9.red("Error:")} ${result.error}`);
@@ -10886,30 +10948,30 @@ ${result.diff}`);
     const mode = opts.smart ? "smart" : "template";
     const memCount = result.context?.metadata.memoriesUsed ?? 0;
     console.log(`  ${pc9.cyan("Recalled:")} ${memCount} memories`);
-    console.log(`  ${pc9.green("\u2713")} CLAUDE.md written (${mode} mode)
+    console.log(`  ${pc9.green("\u2713")} ${target.contextFile} written (${mode} mode)
 `);
   } else if (result.skippedReason === "fresh") {
-    console.log(`  ${pc9.green("\u2713")} CLAUDE.md is up to date
+    console.log(`  ${pc9.green("\u2713")} ${target.contextFile} is up to date
 `);
   }
   if (opts.launch !== false && !opts.diff) {
     const { execFileSync: execFileSync4 } = await import("child_process");
     try {
-      execFileSync4("which", ["claude"], { stdio: "ignore" });
+      execFileSync4("which", [target.launchCmd], { stdio: "ignore" });
     } catch {
-      console.log(`  ${pc9.yellow("Claude Code not found.")} Install: npm install -g @anthropic-ai/claude-code`);
+      console.log(`  ${pc9.yellow(`${target.displayName} not found.`)} Ensure '${target.launchCmd}' is in your PATH.`);
       process.exit(1);
     }
-    const claudeArgs = [];
-    if (opts.yolo) {
-      claudeArgs.push("--dangerously-skip-permissions");
-      console.log(`  ${pc9.cyan("Launching Claude Code")} ${pc9.yellow("(--dangerously-skip-permissions)")}...
+    const launchArgs = [...target.launchArgs];
+    if (opts.yolo && target.yoloArgs) {
+      launchArgs.push(...target.yoloArgs);
+      console.log(`  ${pc9.cyan(`Launching ${target.displayName}`)} ${pc9.yellow("(skip-permissions)")}...
 `);
     } else {
-      console.log(`  ${pc9.cyan("Launching Claude Code...")}
+      console.log(`  ${pc9.cyan(`Launching ${target.displayName}...`)}
 `);
     }
-    execFileSync4("claude", claudeArgs, { cwd: targetPath, stdio: "inherit" });
+    execFileSync4(target.launchCmd, launchArgs, { cwd: targetPath, stdio: "inherit" });
   }
 });
 program.command("setup").description("Run the full configuration wizard (provider, identity, presets)").action(async () => {