@aman_asmuei/aman 0.4.0 → 0.5.1

package/README.md

@@ -92,8 +92,13 @@ Each package works independently. `aman` is the front door.
 | `aman` | First run: setup. After that: show status |
 | `aman setup` | Set up the full ecosystem |
 | `aman status` | View ecosystem status (all layers) |
+| `aman here` | Write a project context card (`.acore/context.md`) for the current directory |
 | `aman deploy` | Deploy your AI anywhere (Docker, Ollama, systemd) |
 
+### `aman here` — project context cards
+
+Run `aman here` in any repo to create a `.acore/context.md` with the detected stack and today's date. The file is read by [aman-claude-code](https://github.com/amanasmuei/aman-claude-code) on every session start and embedded into [aman-copilot](https://github.com/amanasmuei/aman-copilot)'s `copilot-instructions.md` at `init` time — so both surfaces know which project you're in. Use `--force` to overwrite an existing card non-interactively.
+
 After setup, use the individual CLIs for detailed management:
 
 ```bash
@@ -219,6 +224,81 @@ https://amanasmuei.github.io/acore/
 
 ChatGPT, Claude, Claude Code, Cursor, Windsurf, Gemini, Ollama, and any AI that accepts a system prompt.
 
+---
+
+## Full install (all surfaces)
+
+The one-command setup creates your global ecosystem. To light up every surface:
+
+```bash
+# 1. Ecosystem (identity + rules + eval)
+npx @aman_asmuei/aman@latest
+
+# 2. Persistent memory (MCP) — required for cross-surface memory sync
+npx @aman_asmuei/amem
+
+# 3a. Claude Code — plugin + live MCP tools
+claude plugin marketplace add amanasmuei/aman-claude-code
+claude plugin install aman-claude-code@aman
+# Plugin auto-installs the MCP tools on first session start. To install manually:
+# node ~/.claude/plugins/cache/aman/aman-claude-code/*/bin/install-mcp.mjs
+
+# 3b. VS Code Copilot Chat — per project
+cd /path/to/your/project
+npx @aman_asmuei/aman-copilot init
+npx @aman_asmuei/aman-copilot install-mcp --all
+# Then: reload VS Code window, switch Copilot Chat to Agent mode
+
+# 4. Per-project context card (optional, per repo)
+cd /path/to/your/project
+npx @aman_asmuei/aman here
+```
+
+Every step is idempotent — safe to re-run. The plugin + copilot auto-load identity/rules/memory from the global ecosystem; you only need to personalise once.
+
+---
+
+## Uninstall / reset
+
+### Soft reset — keep packages, wipe content, re-run setup
+
+```bash
+rm -rf ~/.acore ~/.arules ~/.aeval
+npx @aman_asmuei/aman@latest
+```
+
+Useful when your identity drifts and you want a clean slate without fully uninstalling.
+
+### Full uninstall — nothing aman-related on disk
+
+```bash
+# 1. Global ecosystem data
+rm -rf ~/.acore ~/.arules ~/.aeval ~/.aflow ~/.akit ~/.askill ~/.amem
+
+# 2. Claude Code plugin + MCP entry
+claude plugin uninstall aman-claude-code@aman
+claude plugin marketplace remove aman
+claude mcp remove aman 2>/dev/null || true
+
+# 3. VS Code + Copilot CLI MCP entries
+npx @aman_asmuei/aman-copilot uninstall-mcp --all
+
+# 4. Per-project files — find every .acore folder you opted in to
+find ~ -maxdepth 4 -type d -name .acore 2>/dev/null
+# Review the list, then delete by hand or:
+# find ~/Projects -maxdepth 4 -type d -name .acore -exec rm -rf {} +
+```
+
+### Per-project only — remove aman from one repo
+
+```bash
+# From the project root
+rm -rf .acore .github/copilot-instructions.md
+rm -f .github/prompts/{identity,rules,eval,remember,session-narrative}.prompt.md
+```
+
+The package `npx` binaries (`aman`, `amem`, `aman-copilot`, etc.) live in npm's cache — `npm cache clean --force` if you want those gone too, but they're tiny and usually not worth the trouble.
+
 ## License
 
 [MIT](LICENSE)

package/dist/index.js

@@ -32,8 +32,8 @@ function detectPlatform(cwd) {
       const raw = fs.readFileSync(configPath, "utf-8");
       const parsed = JSON.parse(raw);
       if (typeof parsed.platform === "string") {
-        const p5 = parsed.platform;
-        if (p5 === "claude-code" || p5 === "cursor" || p5 === "windsurf") return p5;
+        const p6 = parsed.platform;
+        if (p6 === "claude-code" || p6 === "cursor" || p6 === "windsurf") return p6;
       }
     } catch {
     }
@@ -447,6 +447,10 @@ async function setupCommand() {
       fs4.writeFileSync(path3.join(localDir, "context.md"), contextContent, "utf-8");
       const configContent = JSON.stringify({ platform: platform || "other" }, null, 2) + "\n";
       fs4.writeFileSync(path3.join(localDir, "config.json"), configContent, "utf-8");
+    } else {
+      p.log.info(
+        `No project detected here \u2014 run ${pc.bold("aman here")} later from inside any repo to add per-project context.`
+      );
     }
     const platformFile = getPlatformFile(platform);
     if (platformFile) {
@@ -546,6 +550,7 @@ async function setupCommand() {
     `  ${pc.green("\u2714")} Your AI companion is ready.`,
     "",
     `  ${pc.bold("aman status")}             See your full ecosystem`,
+    `  ${pc.bold("aman here")}               Add per-project context (.acore/context.md)`,
     `  ${pc.bold("acore customize")}         Change personality`,
     `  ${pc.bold("askill add testing")}      Install skills`,
     `  ${pc.bold("npx @aman_asmuei/amem")}   Enable automated memory`,
@@ -959,9 +964,75 @@ async function showcaseCommand(nameArg, opts = {}) {
   p4.outro(`${pc4.green("\u2713")} ${entry.title} is ready!`);
 }
 
+// src/commands/here.ts
+import * as p5 from "@clack/prompts";
+import pc5 from "picocolors";
+import fs7 from "fs";
+import path5 from "path";
+async function hereCommand(opts = {}) {
+  const cwd = process.cwd();
+  const acoreDir = path5.join(cwd, ".acore");
+  const contextPath = path5.join(acoreDir, "context.md");
+  const configPath = path5.join(acoreDir, "config.json");
+  if (fs7.existsSync(contextPath) && !opts.force) {
+    p5.intro(pc5.bold("aman here") + " \u2014 project context card");
+    const overwrite = await p5.confirm({
+      message: `${pc5.dim(".acore/context.md")} already exists. Overwrite?`,
+      initialValue: false
+    });
+    if (p5.isCancel(overwrite) || overwrite === false) {
+      p5.outro(pc5.yellow("Skipped. Use --force to overwrite without prompt."));
+      return;
+    }
+  }
+  const stack = detectStack() || "unknown";
+  const platform = detectPlatform();
+  const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  fs7.mkdirSync(acoreDir, { recursive: true });
+  const contextContent = `## Work
+- Stack: ${stack}
+- Domain:
+- Focus:
+
+## Session
+- Last updated: ${today}
+- Resume: [starting fresh]
+- Active topics: []
+- Recent decisions: []
+- Temp notes: []
+
+## Project Patterns
+- [observations specific to this project \u2014 built over time]
+`;
+  fs7.writeFileSync(contextPath, contextContent, "utf-8");
+  if (fs7.existsSync(configPath)) {
+    try {
+      const existing = JSON.parse(fs7.readFileSync(configPath, "utf-8"));
+      if (typeof existing.platform !== "string" || existing.platform === "") {
+        existing.platform = platform || "other";
+        fs7.writeFileSync(configPath, JSON.stringify(existing, null, 2) + "\n", "utf-8");
+      }
+    } catch {
+      const fresh = { platform: platform || "other" };
+      fs7.writeFileSync(configPath, JSON.stringify(fresh, null, 2) + "\n", "utf-8");
+    }
+  } else {
+    const fresh = { platform: platform || "other" };
+    fs7.writeFileSync(configPath, JSON.stringify(fresh, null, 2) + "\n", "utf-8");
+  }
+  if (opts.force) {
+    return;
+  }
+  p5.intro(pc5.bold("aman here") + " \u2014 project context card");
+  p5.log.success(`Wrote ${pc5.dim(".acore/context.md")} (stack: ${stack})`);
+  p5.log.info("Edit it as you work. It is read by aman-claude-code on every session start,");
+  p5.log.info(`and embedded into copilot-instructions.md when you run ${pc5.bold("aman-copilot init")}.`);
+  p5.outro(pc5.green("Done."));
+}
+
 // src/index.ts
 var program = new Command();
-program.name("aman").description("Your complete AI companion \u2014 identity, memory, and tools in one command").version("0.4.0").action(() => {
+program.name("aman").description("Your complete AI companion \u2014 identity, memory, and tools in one command").version("0.5.1").action(() => {
   const ecosystem = detectEcosystem();
   if (ecosystem.acore.installed) {
     statusCommand();
@@ -975,4 +1046,5 @@ program.command("deploy").description("Deploy your AI companion (Docker, systemd
 program.command("showcase [name]").description("Set up a showcase AI companion (rutin, kedai, monitor, ...)").option("--dry-run", "preview files without installing").option("--list", "list all available showcases").action(
   (name, opts) => showcaseCommand(name, opts)
 );
+program.command("here").description("Write a project context card (.acore/context.md) for the current directory").option("--force", "overwrite existing card without prompt").action((opts) => hereCommand(opts));
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aman_asmuei/aman",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Your complete AI companion — identity, memory, and tools in one command",
   "type": "module",
   "bin": {