@aman_asmuei/aman 0.5.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

@@ -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`,
@@ -1027,7 +1032,7 @@ async function hereCommand(opts = {}) {
 
 // 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.5.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();

package/package.json

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