@radix-ai/ai-memory 0.1.1 → 0.1.4

package/README.md

@@ -126,10 +126,13 @@ Creates: `acp/`, `docs-schema.json`, `rules/doc-placement.md`, `agents/docs-mana
 | `/mem-init` | First-time project setup |
 | `/mem-validate` | Before a risky change (Full tier) |
 | `/mem-auto-review` | Automated PR review (Bugbot, CI, automations) |
+| `/browser` | Browser automation (screenshots, navigate, interact) |
+| `/screen-capture` | Desktop/app window screenshot for vision analysis |
+| `/desktop-automation` | Desktop UI automation (mouse, keyboard, OCR) |
 
 ### How to invoke skills
 
-Skills are stored in `.ai/skills/` (canonical) with stubs in `.agents/skills/`. How you invoke them depends on your tool:
+Skills are stored in `.ai/skills/` (canonical) with stubs in your tool's skills directory (e.g., `.cursor/skills/`, `.claude/skills/`, `.agents/skills/` for Antigravity). How you invoke them depends on your tool:
 
 | Tool | How to invoke | Example |
 |------|--------------|---------|
@@ -235,7 +238,7 @@ PROJECT_STATUS.md is writable by default (`writable: true` in frontmatter). This
 4. Next iteration reads the updated PROJECT_STATUS.md
 5. Natural convergence through iteration
 
-This follows the [autoresearch](https://github.com/mutable-state-inc/autoresearch-at-home) pattern and the [Ralph Wiggum](https://ralph-wiggum.ai/) approach: **the plan file on disk is the shared state.**
+This follows the [autoresearch](https://github.com/mutable-state-inc/autoresearch-at-home) pattern and the [Ralph Wiggum](https://ralph-wiggum.ai/) approach: **the status file on disk is the shared state.**
 
 ### Concurrent agents (cloud agents, worktrees, background tasks)
 
@@ -325,7 +328,7 @@ ai-memory eval add my-metric
 
 ## Design
 
-- [Environment adaptation](docs/design/environment-adaptation-plan.md) — Spec-driven detection and injection. Implemented via `detectEnvironments()` in `src/cli/environment.ts` and `install --capability`.
+- **Environment adaptation** — Spec-driven detection and injection. Implemented via `detectEnvironments()` in `src/cli/environment.ts` and `install --capability`.
 
 ---
 
@@ -336,7 +339,7 @@ ai-memory eval add my-metric
 - [compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin) — Plugin this system is modeled after
 - [lossless-claw](https://github.com/Martian-Engineering/lossless-claw) — Lossless context compaction (inspiration for session archive design)
 - [autoresearch-at-home](https://github.com/mutable-state-inc/autoresearch-at-home) — Multi-agent iterative research
-- [Ralph Wiggum](https://ralph-wiggum.ai/) — Iterative agent loops via plan file on disk
+- [Ralph Wiggum](https://ralph-wiggum.ai/) — Iterative agent loops via status file on disk
 
 ---
 

package/dist/cli/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/cli/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,qBAAqB,6/BAkBjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,21CAoCxB,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,MAAM,CAoBnC;AAQD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwLnD,CAAC;AAIF,eAAO,MAAM,kBAAkB,0vCAwC9B,CAAC;AAGF,eAAO,MAAM,gBAAgB,orBAa5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAiBrB,CAAC;AAIZ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAmDrD,CAAC"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/cli/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,qBAAqB,6/BAkBjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,21CAoCxB,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,yBAAyB,CAAC;AAExD,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,MAAM,CAoBnC;AA4BD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAoOnD,CAAC;AAIF,eAAO,MAAM,kBAAkB,0vCAwC9B,CAAC;AAGF,eAAO,MAAM,gBAAgB,orBAa5B,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAiBrB,CAAC;AAIZ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CA4CrD,CAAC"}

package/dist/cli/adapters.js

@@ -88,6 +88,24 @@ export function getMCPJson() {
 function skillStub(name, description) {
     return `---\nname: ${name}\ndescription: ${description}\n---\n\n# ${name}\n\nCanonical definition: \`.ai/skills/${name}/SKILL.md\`\n\nRead the canonical file for full instructions.\n`;
 }
+const SKILL_STUBS = [
+    ["mem-compound", "Captures session learnings into persistent memory."],
+    ["mem-session-close", "Quick session close for sessions with no major learnings."],
+    ["mem-validate", "Validate memory entries and code changes against governance rules."],
+    ["mem-init", "Initialize ai-memory in a new project."],
+    ["browser", "Browser automation (screenshots, navigate, interact)."],
+    ["screen-capture", "Desktop/app window screenshot for vision analysis."],
+    ["desktop-automation", "Desktop UI automation — mouse, keyboard, OCR. For desktop applications, Electron apps."],
+    ["mem-auto-review", "Automated PR review using ai-memory governance rules."],
+];
+/** Generate skill stub files for a given tool-specific skills directory */
+function skillStubsForDir(dir) {
+    const stubs = {};
+    for (const [name, desc] of SKILL_STUBS) {
+        stubs[`${dir}/${name}/SKILL.md`] = skillStub(name, desc);
+    }
+    return stubs;
+}
 /** Full skill content — written to .ai/skills/<name>/SKILL.md by install */
 export const CANONICAL_SKILLS = {
     "mem-compound": `---
@@ -172,19 +190,26 @@ description: Validate memory entries and code changes against governance rules.
 `,
     "mem-init": `---
 name: mem-init
-description: Initialize ai-memory in a new project. Scaffolds the .ai/ directory structure.
+description: Guided setup wizard for ai-memory. Scans the codebase and walks the user through configuring each file with project-specific recommendations. Every step is skippable.
 disable-model-invocation: true
 ---
 
-# mem-init — Project Setup
-
-## Instructions
+# mem-init — Guided Setup Wizard
 
-1. Confirm the user wants to initialize ai-memory in this project
-2. Ask: Default tier or Full tier (adds governance, evals, ACP)?
-3. Run: \`ai-memory init\` (or \`ai-memory init --full\`)
-4. Guide the user to edit \`.ai/IDENTITY.md\` and \`.ai/PROJECT_STATUS.md\`
-5. Run \`ai-memory validate\` to confirm setup
+## When to use
+First time setting up ai-memory, or re-run to refresh recommendations.
+
+**Quick setup (skip wizard):** Run \`npx @radix-ai/ai-memory init\` and edit files manually.
+
+## Steps
+1. **Scaffold** — Run \`npx @radix-ai/ai-memory init\` (or \`--full\`), then \`install --to <tool>\`. Skip if \`.ai/\` exists.
+2. **Codebase scan** — Read: manifest (package.json etc.), README, directory listing, CI config, build config, git log, existing MCPs, existing rules files, existing docs. Summarize internally.
+3. **Guide IDENTITY.md** — Explain each section (Mindset, Autonomy Level, Constraints, Permissions). Suggest project-specific constraints from scan. Ask autonomy level preference (HIGH/MEDIUM/LOW TOUCH). User edits the file. Skippable.
+4. **Guide reference/PROJECT.md** — Present scan findings as suggestions for: Project Overview, Tech Stack, Architecture, Data Models, Integrations, Dev Setup. User edits the file. Skippable.
+5. **Guide PROJECT_STATUS.md** — Suggest Current Focus from git log, Open Questions from scan gaps, What's Working from observed patterns. User edits. Skippable.
+6. **Knowledge audit** — Report existing docs (ARCHITECTURE.md, CONTRIBUTING.md, CHANGELOG.md, .env.example, TODO comments, existing MCPs/rules). Suggest what to import into .ai/memory/. Do not import automatically.
+7. **Recommendations** — Suggest relevant features: CI detected → mem-auto-review, multiple contributors → Full tier, no tests → testing-strategy pattern, monorepo → per-package skills.
+8. **Validate** — Run \`npx @radix-ai/ai-memory validate\`. Print summary of what was done, remaining placeholders, and next steps.
 `,
     browser: `---
 name: browser
@@ -193,6 +218,7 @@ type: skill
 status: active
 requires:
   capabilities: [browser]
+  permission: read   # read | edit | write — only request what the task needs
 ---
 
 # browser — Browser Automation Skill
@@ -238,6 +264,42 @@ See \`.ai/reference/capability-specs.json\` for platform-specific install (e.g.
 
 - Capture → save to \`.ai/temp/\` → agent reads via file or \`get_memory\`
 - Handoff: write path to \`.ai/temp/request-for-*.md\` for another agent
+`,
+    "desktop-automation": `---
+name: desktop-automation
+description: Desktop UI automation — mouse, keyboard, OCR. For any desktop application, Electron apps, legacy software. Requires desktop_automation capability.
+type: skill
+status: active
+requires:
+  capabilities: [desktop_automation]
+---
+
+# desktop-automation — Desktop UI Automation Skill
+
+## When to use
+
+- Type into any desktop application or Electron apps
+- Automate legacy desktop apps without APIs
+- UI testing, data entry, accessibility tools
+
+## Permissions
+
+Declare the minimal permission needed for the task (see capability-specs.json):
+- **read** — Observe, screenshot, OCR only
+- **edit** — Click, type, navigate (no destructive actions)
+- **write** — Full control (submit, delete, etc.)
+
+Only request the permission the task requires.
+
+## Setup
+
+- **Cursor/Claude Code/Windsurf/Cline:** Run \`ai-memory install --capability desktop_automation\`
+- **Antigravity:** Add computer-control-mcp to \`~/.gemini/antigravity/mcp_config.json\` manually. Requires \`uvx\` (uv) or \`pip install computer-control-mcp\`.
+
+## Usage
+
+- Use mouse/keyboard tools for interaction; OCR for reading screen content
+- Save captures to \`.ai/temp/\` for handoff
 `,
     "mem-auto-review": `---
 name: mem-auto-review
@@ -356,14 +418,15 @@ export const TOOL_ADAPTERS = {
         mcp: true,
         mcpPath: ".cursor/mcp.json",
         extraFiles: {
-            // Stubs in .agents/skills/ point to canonical .ai/skills/
-            ".agents/skills/mem-compound/SKILL.md": skillStub("mem-compound", "Captures session learnings into persistent memory."),
-            ".agents/skills/mem-session-close/SKILL.md": skillStub("mem-session-close", "Quick session close for sessions with no major learnings."),
-            ".agents/skills/mem-validate/SKILL.md": skillStub("mem-validate", "Validate memory entries and code changes against governance rules."),
-            ".agents/skills/mem-init/SKILL.md": skillStub("mem-init", "Initialize ai-memory in a new project."),
-            ".agents/skills/browser/SKILL.md": skillStub("browser", "Browser automation (screenshots, navigate, interact)."),
-            ".agents/skills/screen-capture/SKILL.md": skillStub("screen-capture", "Desktop/app window screenshot for vision analysis."),
-            ".agents/skills/mem-auto-review/SKILL.md": skillStub("mem-auto-review", "Automated PR review using ai-memory governance rules."),
+            ...skillStubsForDir(".cursor/skills"),
+        },
+    },
+    antigravity: {
+        dest: ".agents/rules/00-load-ai-memory.md",
+        content: BOOTSTRAP_INSTRUCTION,
+        mcp: false, // Antigravity MCP is global-only (~/.gemini/antigravity/mcp_config.json)
+        extraFiles: {
+            ...skillStubsForDir(".agents/skills"),
         },
     },
     windsurf: {
@@ -386,15 +449,7 @@ export const TOOL_ADAPTERS = {
         content: `# Claude Code — Project Memory\n\n${BOOTSTRAP_INSTRUCTION}`,
         mcp: true,
         extraFiles: {
-            // Stubs in .agents/skills/ point to canonical .ai/skills/
-            ".agents/skills/mem-compound/SKILL.md": skillStub("mem-compound", "Captures session learnings into persistent memory."),
-            ".agents/skills/mem-session-close/SKILL.md": skillStub("mem-session-close", "Quick session close for sessions with no major learnings."),
-            ".agents/skills/mem-validate/SKILL.md": skillStub("mem-validate", "Validate memory entries and code changes against governance rules."),
-            ".agents/skills/mem-init/SKILL.md": skillStub("mem-init", "Initialize ai-memory in a new project."),
-            ".agents/skills/browser/SKILL.md": skillStub("browser", "Browser automation (screenshots, navigate, interact)."),
-            ".agents/skills/screen-capture/SKILL.md": skillStub("screen-capture", "Desktop/app window screenshot for vision analysis."),
-            ".agents/skills/mem-auto-review/SKILL.md": skillStub("mem-auto-review", "Automated PR review using ai-memory governance rules."),
-            // Claude Code hooks (SessionStart, PreCompact)
+            ...skillStubsForDir(".claude/skills"),
             ".claude/hooks/SessionStart.js": SESSION_START_HOOK,
             ".claude/hooks/PreCompact.js": PRE_COMPACT_HOOK,
             ".claude/settings.local.json": CLAUDE_HOOKS_CONFIG,

package/dist/cli/adapters.js.map

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

package/dist/cli/environment.d.ts

@@ -25,6 +25,8 @@ export declare function detectEnvironments(projectRoot: string, packageRoot: str
  * Reads from capability-specs.json → environments[envId].
  */
 export declare function getCapabilityConfig(capability: string, envId: string, projectRoot: string, packageRoot: string): unknown;
+/** Get manual setup instructions when capability has manual config for an environment. */
+export declare function getCapabilityManualInstructions(capability: string, envId: string, projectRoot: string, packageRoot: string): string | null;
 /**
  * Inject MCP config for a capability into the environment's config file.
  * Merges new server entry into mcpServers; does not overwrite existing ai-memory.

package/dist/cli/environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/cli/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAoBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAOT;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAcT"}
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/cli/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAoBD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAWrF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAOT;AAED,0FAA0F;AAC1F,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAKf;AAWD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAcT"}

package/dist/cli/environment.js

@@ -53,12 +53,21 @@ export function getCapabilityConfig(capability, envId, projectRoot, packageRoot)
     const envConfig = cap.environments?.[envId];
     return envConfig ?? null;
 }
+/** Get manual setup instructions when capability has manual config for an environment. */
+export function getCapabilityManualInstructions(capability, envId, projectRoot, packageRoot) {
+    const config = getCapabilityConfig(capability, envId, projectRoot, packageRoot);
+    if (!config || typeof config !== "object")
+        return null;
+    const manual = config.manual;
+    return typeof manual === "string" ? manual : null;
+}
 /** MCP config paths per environment (relative to project root). Matches install adapter mcpPath. */
 const ENV_MCP_PATHS = {
     cursor: ".cursor/mcp.json",
     "claude-code": ".mcp.json",
     windsurf: ".mcp.json",
     cline: ".mcp.json",
+    antigravity: ".mcp.json", // Antigravity uses global config; project path unused for injection
 };
 /**
  * Inject MCP config for a capability into the environment's config file.
@@ -92,6 +101,8 @@ function loadMcpConfig(path) {
 function mcpEntryFromCapConfig(capability, config) {
     if (config.native === true)
         return null; // Cursor has browser natively; no injection
+    if (config.manual !== undefined)
+        return null; // Manual setup (e.g. Antigravity global MCP)
     const mcp = config.mcp;
     if (!mcp || typeof mcp !== "object")
         return null;
@@ -109,9 +120,13 @@ function mcpEntryFromCapConfig(capability, config) {
     }
     return null;
 }
+const CAPABILITY_MCP_KEYS = {
+    browser: "cursor-ide-browser",
+    desktop_automation: "computer-control-mcp",
+};
 function mergeMcpConfig(existing, capability, entry) {
     const servers = { ...(existing.mcpServers ?? {}) };
-    const key = capability === "browser" ? "cursor-ide-browser" : `capability-${capability}`;
+    const key = CAPABILITY_MCP_KEYS[capability] ?? `capability-${capability}`;
     if (!servers[key])
         servers[key] = entry;
     return { ...existing, mcpServers: servers };

package/dist/cli/environment.js.map

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

package/dist/cli/index.js

@@ -6,7 +6,7 @@ import { existsSync, readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { DEFAULT_DOCS_SCHEMA_JSON } from "../docs-schema.js";
 import { TOOL_ADAPTERS, getMCPJson, MCP_LAUNCHER, MCP_LAUNCHER_PATH, CANONICAL_SKILLS } from "./adapters.js";
-import { detectEnvironments, injectCapabilityConfig } from "./environment.js";
+import { detectEnvironments, injectCapabilityConfig, getCapabilityManualInstructions } from "./environment.js";
 // Read version from package.json — single source of truth
 const __dirname_cli = dirname(fileURLToPath(import.meta.url));
 const pkgPath = join(__dirname_cli, "..", "..", "package.json");
@@ -63,14 +63,12 @@ program
         await warmSearchModel();
         console.log(`✓ Model ready.`);
     }
-    console.log(`\n✓ Done. Next steps:`);
-    console.log(`  1. Edit .ai/IDENTITY.md — describe this project and its constraints`);
-    console.log(`  2. Edit .ai/PROJECT_STATUS.md — set the current focus`);
-    console.log(`  3. Run \`ai-memory install --to cursor\` or \`--to claude-code\` to connect your tool`);
-    if (opts.full) {
-        console.log(`  4. Add [P0] entries with constraint_pattern to decisions.md for governance`);
-        console.log(`  5. Run \`ai-memory generate-harness\` to compile the rule set`);
-    }
+    console.log(`\n✓ Done. Next step:`);
+    console.log(`  Run /mem-init in your AI tool for guided setup with project-specific recommendations.`);
+    console.log(`  Or manually edit .ai/IDENTITY.md and .ai/PROJECT_STATUS.md.`);
+    console.log(``);
+    console.log(`  Connect your tool:  npx @radix-ai/ai-memory install --to <tool>`);
+    console.log(`  Supported tools:   cursor, claude-code, antigravity, windsurf, cline, copilot`);
 });
 async function scaffoldAiDir(aiDir, full) {
     // Core dirs (always)
@@ -148,7 +146,7 @@ program
     .description("Install the ai-memory bootstrap for a specific tool")
     .requiredOption("--to <tool>", `Target tool (${Object.keys(TOOL_ADAPTERS).join(", ")})`)
     .option("--dir <dir>", "Project root (default: current directory)")
-    .option("--capability <cap>", "Inject capability config (browser, screen_capture). Repeatable.", (v, acc) => (acc ?? []).concat(v), [])
+    .option("--capability <cap>", "Inject capability config (browser, screen_capture, desktop_automation). Repeatable.", (v, acc) => (acc ?? []).concat(v), [])
     .action(async (opts) => {
     const tool = opts.to.toLowerCase();
     const adapter = TOOL_ADAPTERS[tool];
@@ -212,8 +210,9 @@ program
         const pkgRoot = join(__dirname_cli, "..", "..");
         const envs = detectEnvironments(projectRoot, pkgRoot);
         for (const cap of capabilities) {
-            if (cap !== "browser" && cap !== "screen_capture") {
-                console.warn(`  [warn] Unknown capability: ${cap}. Skipping.`);
+            const knownCaps = ["browser", "screen_capture", "desktop_automation"];
+            if (!knownCaps.includes(cap)) {
+                console.warn(`  [warn] Unknown capability: ${cap}. Skipping. Known: ${knownCaps.join(", ")}`);
                 continue;
             }
             let injected = 0;
@@ -231,11 +230,28 @@ program
             if (cap === "screen_capture" && injected === 0 && envs.length > 0) {
                 console.warn(`  [warn] screen_capture has no MCP config — it uses platform tools (e.g. Peekaboo). See capability-specs.json.`);
             }
+            // Print manual instructions for capabilities that require global/manual setup (e.g. Antigravity + desktop_automation)
+            for (const envId of envs) {
+                const manual = getCapabilityManualInstructions(cap, envId, projectRoot, pkgRoot);
+                if (manual) {
+                    console.log(`  [${envId}] ${cap}: ${manual}`);
+                }
+            }
         }
     }
-    console.log(`\nDone. Start a new ${opts.to} session and verify:`);
-    console.log(`  1. MCP connected: "Call search_memory with query 'test'" (should return results, not an error)`);
-    console.log(`  2. Memory loaded:  "What does .ai/IDENTITY.md say about this project?"`);
+    console.log(`\nDone. Before starting:`);
+    if (tool === "antigravity") {
+        console.log(`  1. Add ai-memory MCP to ~/.gemini/antigravity/mcp_config.json (Antigravity uses global MCP config)`);
+        console.log(`  2. Start a new session and verify with: "What does .ai/IDENTITY.md say about this project?"`);
+    }
+    else if (adapter.mcp) {
+        console.log(`  1. Enable the ai-memory MCP server in your tool's settings (it's disabled by default)`);
+        console.log(`  2. Start a new session and verify with: "What does .ai/IDENTITY.md say about this project?"`);
+    }
+    else {
+        console.log(`  1. Start a new session and verify with: "What does .ai/IDENTITY.md say about this project?"`);
+    }
+    console.log(`  Run /mem-init for guided onboarding.`);
     console.log(`\nIf search_memory is not available, restart your editor — MCP servers load at startup.`);
 });
 // ─── mcp ────────────────────────────────────────────────────────────────────
@@ -760,31 +776,79 @@ const DEFAULT_IDENTITY = `---
 id: identity
 type: identity
 status: active
-writable: false
+writable: true
 last_updated: ${new Date().toISOString().slice(0, 10)}
 ---
 
 # Identity
 
-You are a senior developer focused on long-term strategy and production readiness.
+You are a senior developer focused on long-term strategy and production readiness. You think beyond the immediate task — anticipating downstream effects, architectural implications, and long-term maintainability. Every decision is deliberate, forward-looking, and grounded in engineering excellence.
+
+## Mindset
+
+- Think about gaps and edge cases before writing code
+- Propose solutions that are production-grade, not prototypes
+- When diagnosing an issue, consider the full call chain — not just the immediate symptom
+- [Add project-specific mindset guidance here]
+
+## Autonomy Level
 
-## What this project is
+<!-- Set one of: HIGH_TOUCH, MEDIUM_TOUCH, LOW_TOUCH -->
+level: HIGH_TOUCH
 
-[Describe the project here — one paragraph]
+### HIGH_TOUCH (default)
+**ASK before:** architectural changes, scope changes, trade-offs, ambiguous requirements, irreversible actions.
+**DO NOT ask for:** permission to search/read, executing decided approach, gathering info.
+**Long-running agents:** checkpoint at phase transitions.
+
+### MEDIUM_TOUCH
+**ASK before:** irreversible actions, breaking changes, security-sensitive changes.
+**Proceed autonomously with:** refactors, test additions, dependency updates, documentation.
+**Checkpoint:** only on scope changes.
+
+### LOW_TOUCH
+**ASK before:** production deployments, data deletion, security rule changes.
+**Proceed autonomously with:** everything else.
+**Checkpoint:** only on errors or blockers.
 
 ## Constraints (NEVER without explicit approval)
 
 - Never commit secrets, API keys, or .env files
 - Never delete user data without explicit request
 - Never deploy to production without explicit request
-- Never write full protocols to tool directories — canonical content goes in \`.ai/\`
+- Never write full protocols to tool directories — canonical content goes in \`.ai/\`, stubs in tool dirs
+- Always use \`commit_memory\` MCP tool for writing to \`.ai/memory/\`. Never edit memory files directly.
+- [Add project-specific constraints here]
+
+## Permissions (ASK before doing)
+
+- Creating new files (prefer editing existing)
+- Adding dependencies
+- [Add project-specific permissions here]
 
-## Before starting any task
+## Before Starting Any Task
 
 1. Read \`.ai/memory/memory-index.md\`
-2. Search \`.ai/memory/\` for relevant bugs, patterns, and decisions
+2. Search \`.ai/memory/\` for bugs, patterns, decisions relevant to the task
 3. Search \`.ai/skills/\` for applicable domain patterns
-4. Fetch \`.ai/reference/PROJECT.md\` only when the task requires architecture or data model context
+4. Fetch \`.ai/reference/PROJECT.md\` only when task requires architecture, data models, or integrations
+
+## Inference Discipline
+
+1. **State inferences explicitly**: "I'm inferring X because Y"
+2. **Check memory for conflicts**: Search \`.ai/memory/\` before acting on inference
+3. **Surface uncertainty**: If confidence < 90%, say so and ask
+4. **Never reduce scope silently**: All content is tool-agnostic by default
+
+After completing any non-trivial task, self-verify: Did I answer what was asked, or what I assumed was asked?
+
+## Authority (when sources conflict)
+
+PROJECT.md > memory files > code > inference.
+
+## When Confused
+
+Tell the user. Fix the code, not the documentation.
 `;
 const DEFAULT_PROJECT_STATUS = `---
 id: project-status
@@ -796,7 +860,7 @@ last_updated: ${new Date().toISOString().slice(0, 10)}
 
 # Project Status
 
-> This file evolves with the project. Both humans and AI update it — AI writes what it learned, humans steer the focus. This is your RALPH loop plan file.
+> This file evolves with the project. Both humans and AI update it — AI writes what it learned, humans steer the focus. This is your RALPH loop status file.
 
 ## Current Focus
 
@@ -993,31 +1057,47 @@ Curated history of past session decisions. One line per session.
 <!-- Format: [YYYY-MM-DD] Brief description of what was done and decided. -->
 `;
 const DEFAULT_PROJECT = `---
-id: project
-type: toolbox
+id: project-reference
+type: reference
 status: active
 last_updated: ${new Date().toISOString().slice(0, 10)}
 ---
 
-# Project
+# Project Reference
 
-**Loaded on demand** — fetched only when a task requires architecture, data models, or integration context.
+**Full project reference for AI agents. Fetch this file when the task requires architecture, data models, integrations, or development setup.**
 
-## Architecture
+Load this file only when the task requires full project context. Prefer \`memory-index.md\` for session start.
 
-[Describe the system architecture]
+---
+
+## Project Overview
+
+[What this project is, who it's for, what problem it solves]
 
 ## Tech Stack
 
-[List the key technologies]
+- **Language:** [e.g., TypeScript, Python, Go]
+- **Framework:** [e.g., React, FastAPI, none]
+- **Build:** [e.g., Vite, webpack, tsc, cargo]
+- **CI:** [e.g., GitHub Actions, GitLab CI, none]
+- **Key dependencies:** [Top 5-8 from manifest file]
+
+## Architecture
+
+[High-level structure — e.g., "Monorepo with packages/ for shared libs", "Single Express API with PostgreSQL"]
 
 ## Data Models
 
-[Describe key data structures]
+[Schema files, ORM models, key types. Remove this section if not applicable.]
 
 ## Integrations
 
-[List external services and APIs]
+[External services — e.g., "Stripe (payments)", "SendGrid (email)", "PostgreSQL (primary DB)". Remove if not applicable.]
+
+## Development Setup
+
+[How to run the project locally — from README, Makefile, docker-compose, .env.example]
 `;
 const DEFAULT_ACP_MANIFEST = JSON.stringify({
     name: "ai-memory-agent",