@fingerskier/augment 0.1.0 → 0.1.2

package/README.md

@@ -1,130 +1,174 @@
-# augment
-
-Local RAG memory for coding agents.
-
-Augment stores durable memories as markdown files, maintains a local rebuildable index, and exposes the memory system through an MCP server.
-The MCP server connects to a shared local daemon, so multiple coding agents can use the same memory folder without each running its own watcher/indexer.
-
-Feature details live in [docs/FEATURES.md](docs/FEATURES.md).
-The implementation plan lives in [PLAN.md](PLAN.md).
-
-----
-
-## Install
-
-From this repo:
-
-```powershell
-npm install
-npm run build
-npm run check
-```
-
----
-
-## Configure Memory
-
-For quick local testing, set the memory root with an environment variable:
+# augment
+
+Local RAG memory for coding agents.
+
+Augment stores durable memories as markdown files, maintains a local rebuildable index, and exposes the memory system through an MCP server.
+The MCP server connects to a shared local daemon, so multiple coding agents can use the same memory folder without each running its own watcher/indexer.
+
+Feature details live in [docs/FEATURES.md](docs/FEATURES.md).
+The implementation plan lives in [PLAN.md](PLAN.md).
+
+----
+
+## Install
+
+From this repo:
+
+```powershell
+npm install
+npm run build
+npm run check
+```
+
+---
+
+## Configure Memory
+
+For quick local testing, set the memory root with an environment variable:
+
+```powershell
+$env:AUGMENT_MEMORY_ROOT = "C:\Users\you\Dropbox\augment-memories"
+```
+
+Or create `~/.augment/config.json`:
+
+```json
+{
+  "memoryRoot": "C:\\Users\\you\\Dropbox\\augment-memories",
+  "stateDir": "C:\\Users\\you\\.augment\\state"
+}
+```
+
+Defaults:
+
+- Memory root: `~/.augment/memories`
+- State directory: `~/.augment/state`
+
+## Run Locally
+
+Run diagnostics:
+
+```powershell
+node .\dist\bin\augment.js status
+```
+
+Start the daemon manually:
+
+```powershell
+node .\dist\bin\augment-daemon.js
+```
+
+Normally you do not need to start the daemon yourself. `augment-mcp` starts or
+connects to the shared daemon automatically.
+
+Run the MCP server manually:
+
+```powershell
+node .\dist\bin\augment-mcp.js
+```
+
+It will appear idle in a terminal because it speaks MCP over stdio.
+
+Do not use `npx @fingerskier/augment` from inside this repository. npm resolves
+the current package first, but a package's own bins are not linked into its local
+`node_modules/.bin`, so Windows reports `augment` as not recognized. Use the
+compiled `node .\dist\bin\...` commands above while working in this repo.
+
+From another directory, the published package works:
+
+```powershell
+npx @fingerskier/augment
+npm exec --yes --package @fingerskier/augment -- augment status
+```
+
+## Local MCP Config
+
+Use the compiled local MCP bin while dogfooding:
+
+```json
+{
+  "mcpServers": {
+    "augment": {
+      "command": "node",
+      "args": ["C:\\dev\\fingerskier\\agent\\augment\\dist\\bin\\augment-mcp.js"],
+      "env": {
+        "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
+      }
+    }
+  }
+}
+```
+
+Alternative using npm from another working directory:
+
+```json
+{
+  "mcpServers": {
+    "augment": {
+      "command": "npm",
+      "args": [
+        "exec",
+        "--prefix",
+        "C:\\dev\\fingerskier\\agent\\augment",
+        "--",
+        "augment-mcp"
+      ],
+      "env": {
+        "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
+      }
+    }
+  }
+}
+```
+
+Dogfooding instructions:
+
+- Codex: [integrations/codex/SKILL.md](integrations/codex/SKILL.md)
+- Claude: [integrations/claude/CLAUDE.md](integrations/claude/CLAUDE.md)
+
+## Install Agent Integrations
+
+Install the Codex plugin and marketplace entry:
+
+```powershell
+npm exec --yes --package @fingerskier/augment -- augment install codex --scope user --memory-root "C:\Users\you\Dropbox\augment-memories"
+```
+
+Install Claude instructions:
+
+```powershell
+npm exec --yes --package @fingerskier/augment -- augment install claude --scope repo --memory-root "C:\Users\you\Dropbox\augment-memories"
+```
+
+Install both:
+
+```powershell
+npm exec --yes --package @fingerskier/augment -- augment install all --scope user --memory-root "C:\Users\you\Dropbox\augment-memories"
+```
+
+Preview writes before changing files:
 
 ```powershell
-$env:AUGMENT_MEMORY_ROOT = "C:\Users\you\Dropbox\augment-memories"
+npm exec --yes --package @fingerskier/augment -- augment install codex --scope user --dry-run
 ```
 
-Or create `~/.augment/config.json`:
-
-```json
-{
-  "memoryRoot": "C:\\Users\\you\\Dropbox\\augment-memories",
-  "stateDir": "C:\\Users\\you\\.augment\\state"
-}
-```
-
-Defaults:
-
-- Memory root: `~/.augment/memories`
-- State directory: `~/.augment/state`
-
-## Run Locally
-
-Run diagnostics:
-
-```powershell
-node .\dist\bin\augment.js status
-```
-
-Start the daemon manually:
-
-```powershell
-node .\dist\bin\augment-daemon.js
-```
-
-Normally you do not need to start the daemon yourself. `augment-mcp` starts or
-connects to the shared daemon automatically.
-
-Run the MCP server manually:
-
-```powershell
-node .\dist\bin\augment-mcp.js
-```
-
-It will appear idle in a terminal because it speaks MCP over stdio.
-
-## Local MCP Config
-
-Use the compiled local MCP bin while dogfooding:
-
-```json
-{
-  "mcpServers": {
-    "augment": {
-      "command": "node",
-      "args": ["C:\\dev\\fingerskier\\agent\\augment\\dist\\bin\\augment-mcp.js"],
-      "env": {
-        "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
-      }
-    }
-  }
-}
-```
-
-Alternative using npm from another working directory:
-
-```json
-{
-  "mcpServers": {
-    "augment": {
-      "command": "npm",
-      "args": [
-        "exec",
-        "--prefix",
-        "C:\\dev\\fingerskier\\agent\\augment",
-        "--",
-        "augment-mcp"
-      ],
-      "env": {
-        "AUGMENT_MEMORY_ROOT": "C:\\Users\\you\\Dropbox\\augment-memories"
-      }
-    }
-  }
-}
-```
-
-Dogfooding instructions:
-
-- Codex: [integrations/codex/SKILL.md](integrations/codex/SKILL.md)
-- Claude: [integrations/claude/CLAUDE.md](integrations/claude/CLAUDE.md)
-
-## Package Check
-
-Before publishing:
-
-```powershell
-npm run check
-npm pack --dry-run
-```
-
-The package exposes these bins:
-
-- `augment`
-- `augment-daemon`
-- `augment-mcp`
+The installer configures MCP commands with an isolated npm `--prefix` directory
+under `~/.augment/npm-exec` so they work even when launched from this repository.
+
+Run these package commands from outside this repository. When developing inside
+this repo, use `node .\dist\bin\augment.js install ...` after `npm run build`.
+
+## Package Check
+
+Before publishing:
+
+```powershell
+npm run check
+npm pack --dry-run
+```
+
+The package exposes these bins:
+
+- `augment`
+- `augment-daemon`
+- `augment-mcp`

package/dist/cli.js

@@ -1,4 +1,5 @@
 import { loadConfig } from "./config.js";
+import { installIntegration } from "./install.js";
 export async function runCli(args) {
     const command = args[0] ?? "status";
     if (command === "config" || command === "status") {
@@ -6,8 +7,56 @@ export async function runCli(args) {
         console.log(JSON.stringify(config, null, 2));
         return;
     }
+    if (command === "install") {
+        const parsed = parseInstallArgs(args.slice(1));
+        const plan = await installIntegration(parsed);
+        for (const line of plan.summary) {
+            console.log(line);
+        }
+        for (const file of plan.files) {
+            console.log(`- ${file}`);
+        }
+        return;
+    }
     console.error(`Unknown command: ${command}`);
-    console.error("Usage: augment [status|config]");
+    console.error("Usage: augment [status|config|install <codex|claude|all>]");
     process.exitCode = 1;
 }
+function parseInstallArgs(args) {
+    const target = args[0];
+    if (!target || !["codex", "claude", "all"].includes(target)) {
+        throw new Error("Usage: augment install <codex|claude|all> [--scope user|repo] [--memory-root PATH] [--dry-run]");
+    }
+    let scope = "user";
+    let memoryRoot;
+    let dryRun = false;
+    for (let index = 1; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--scope") {
+            const value = args[++index];
+            if (value !== "user" && value !== "repo") {
+                throw new Error("--scope must be user or repo");
+            }
+            scope = value;
+        }
+        else if (arg === "--memory-root") {
+            memoryRoot = args[++index];
+            if (!memoryRoot) {
+                throw new Error("--memory-root requires a path");
+            }
+        }
+        else if (arg === "--dry-run") {
+            dryRun = true;
+        }
+        else {
+            throw new Error(`Unknown install option: ${arg}`);
+        }
+    }
+    return {
+        target,
+        scope,
+        memoryRoot,
+        dryRun,
+    };
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;IAEpC,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/install.d.ts

@@ -0,0 +1,15 @@
+export type InstallTarget = "codex" | "claude" | "all";
+export type InstallScope = "user" | "repo";
+export interface InstallOptions {
+    target: InstallTarget;
+    scope: InstallScope;
+    memoryRoot?: string;
+    dryRun?: boolean;
+    cwd?: string;
+    home?: string;
+}
+export interface InstallPlan {
+    summary: string[];
+    files: string[];
+}
+export declare function installIntegration(options: InstallOptions): Promise<InstallPlan>;

package/dist/install.js

@@ -0,0 +1,245 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const PLUGIN_NAME = "augment";
+const CODEX_SKILL_NAME = "augment-context";
+const BEGIN_MARKER = "<!-- augment:start -->";
+const END_MARKER = "<!-- augment:end -->";
+export async function installIntegration(options) {
+    const context = {
+        cwd: path.resolve(options.cwd ?? process.cwd()),
+        home: path.resolve(options.home ?? homedir()),
+        dryRun: options.dryRun ?? false,
+    };
+    const summary = [];
+    const files = [];
+    if (options.target === "codex" || options.target === "all") {
+        const plan = await installCodex({ ...options, ...context });
+        summary.push(...plan.summary);
+        files.push(...plan.files);
+    }
+    if (options.target === "claude" || options.target === "all") {
+        const plan = await installClaude({ ...options, ...context });
+        summary.push(...plan.summary);
+        files.push(...plan.files);
+    }
+    return { summary, files };
+}
+async function installCodex(options) {
+    const paths = codexPaths(options);
+    const packageInfo = await readPackageInfo();
+    const skill = await readTemplate("integrations/codex/SKILL.md");
+    const mcpConfig = {
+        mcpServers: {
+            augment: {
+                command: "npm",
+                args: augmentMcpArgs(paths.npmExecPrefix),
+                env: envConfig(options.memoryRoot),
+            },
+        },
+    };
+    const pluginJson = {
+        name: PLUGIN_NAME,
+        version: packageInfo.version,
+        description: "Local RAG memory for coding agents.",
+        author: {
+            name: "fingerskier",
+        },
+        homepage: "https://www.npmjs.com/package/@fingerskier/augment",
+        license: "Apache-2.0",
+        keywords: ["mcp", "memory", "rag", "codex"],
+        skills: "./skills/",
+        mcpServers: "./.mcp.json",
+        interface: {
+            displayName: "Augment",
+            shortDescription: "Local RAG memory for coding agents.",
+            longDescription: "Augment gives Codex a local, file-backed memory system through MCP, with a shared daemon watcher and searchable project memories.",
+            developerName: "fingerskier",
+            category: "Productivity",
+            capabilities: ["MCP", "Local"],
+            defaultPrompt: [
+                "Search Augment memories for this task.",
+                "Record this decision in Augment.",
+                "Update project memory after this change.",
+            ],
+            brandColor: "#2563EB",
+        },
+    };
+    const marketplace = await updateMarketplace(paths.marketplacePath, paths.marketplaceName);
+    const writes = [
+        writePlan(paths.pluginJsonPath, `${JSON.stringify(pluginJson, null, 2)}\n`),
+        writePlan(paths.mcpConfigPath, `${JSON.stringify(mcpConfig, null, 2)}\n`),
+        writePlan(paths.skillPath, skill),
+        writePlan(paths.marketplacePath, `${JSON.stringify(marketplace, null, 2)}\n`),
+    ];
+    if (!options.dryRun) {
+        await mkdir(paths.npmExecPrefix, { recursive: true });
+        for (const write of writes) {
+            await writeFileEnsured(write.file, write.content);
+        }
+    }
+    return {
+        summary: [
+            `${options.dryRun ? "Would install" : "Installed"} Codex plugin '${PLUGIN_NAME}' (${options.scope} scope).`,
+            `${options.dryRun ? "Would update" : "Updated"} Codex marketplace at ${paths.marketplacePath}.`,
+        ],
+        files: writes.map((write) => write.file),
+    };
+}
+async function installClaude(options) {
+    const npmExecPrefix = sharedNpmExecPrefix(options.home);
+    const targetPath = options.scope === "user" ? path.join(options.home, ".claude", "CLAUDE.md") : path.join(options.cwd, "CLAUDE.md");
+    const template = await readTemplate("integrations/claude/CLAUDE.md");
+    const block = [
+        BEGIN_MARKER,
+        "",
+        template.trim(),
+        "",
+        "## MCP Server",
+        "",
+        "Add this to Claude's MCP configuration (`.mcp.json` at the repo root, or `~/.claude.json`):",
+        "",
+        "```json",
+        JSON.stringify({
+            mcpServers: {
+                augment: {
+                    command: "npm",
+                    args: augmentMcpArgs(npmExecPrefix),
+                    env: envConfig(options.memoryRoot),
+                },
+            },
+        }, null, 2),
+        "```",
+        "",
+        END_MARKER,
+        "",
+    ].join("\n");
+    const existing = await readOptional(targetPath);
+    const content = upsertMarkedBlock(existing, block);
+    if (!options.dryRun) {
+        await mkdir(npmExecPrefix, { recursive: true });
+        await writeFileEnsured(targetPath, content);
+    }
+    return {
+        summary: [`${options.dryRun ? "Would install" : "Installed"} Claude instructions (${options.scope} scope).`],
+        files: [targetPath],
+    };
+}
+function codexPaths(options) {
+    if (options.scope === "repo") {
+        const pluginRoot = path.join(options.cwd, "plugins", PLUGIN_NAME);
+        return {
+            pluginRoot,
+            pluginJsonPath: path.join(pluginRoot, ".codex-plugin", "plugin.json"),
+            mcpConfigPath: path.join(pluginRoot, ".mcp.json"),
+            skillPath: path.join(pluginRoot, "skills", CODEX_SKILL_NAME, "SKILL.md"),
+            marketplacePath: path.join(options.cwd, ".agents", "plugins", "marketplace.json"),
+            marketplaceName: "local-repo",
+            npmExecPrefix: sharedNpmExecPrefix(options.home),
+        };
+    }
+    const pluginRoot = path.join(options.home, "plugins", PLUGIN_NAME);
+    return {
+        pluginRoot,
+        pluginJsonPath: path.join(pluginRoot, ".codex-plugin", "plugin.json"),
+        mcpConfigPath: path.join(pluginRoot, ".mcp.json"),
+        skillPath: path.join(pluginRoot, "skills", CODEX_SKILL_NAME, "SKILL.md"),
+        marketplacePath: path.join(options.home, ".agents", "plugins", "marketplace.json"),
+        marketplaceName: "personal",
+        npmExecPrefix: sharedNpmExecPrefix(options.home),
+    };
+}
+function sharedNpmExecPrefix(home) {
+    return path.join(home, ".augment", "npm-exec");
+}
+function augmentMcpArgs(prefix) {
+    return ["exec", "--yes", "--prefix", prefix, "--package", "@fingerskier/augment", "--", "augment-mcp"];
+}
+async function updateMarketplace(marketplacePath, marketplaceName) {
+    const existing = await readOptionalJson(marketplacePath);
+    const marketplace = existing ?? {
+        name: marketplaceName,
+        interface: {
+            displayName: marketplaceName === "personal" ? "Personal" : "Local Repo",
+        },
+        plugins: [],
+    };
+    marketplace.name ??= marketplaceName;
+    marketplace.interface ??= {
+        displayName: marketplaceName === "personal" ? "Personal" : "Local Repo",
+    };
+    marketplace.plugins ??= [];
+    const entry = {
+        name: PLUGIN_NAME,
+        source: {
+            source: "local",
+            path: `./plugins/${PLUGIN_NAME}`,
+        },
+        policy: {
+            installation: "AVAILABLE",
+            authentication: "ON_INSTALL",
+        },
+        category: "Productivity",
+    };
+    const index = marketplace.plugins.findIndex((plugin) => plugin.name === PLUGIN_NAME);
+    if (index >= 0) {
+        marketplace.plugins[index] = entry;
+    }
+    else {
+        marketplace.plugins.push(entry);
+    }
+    return marketplace;
+}
+function envConfig(memoryRoot) {
+    return memoryRoot ? { AUGMENT_MEMORY_ROOT: path.resolve(memoryRoot) } : {};
+}
+function upsertMarkedBlock(existing, block) {
+    if (!existing || existing.trim().length === 0) {
+        return block;
+    }
+    const start = existing.indexOf(BEGIN_MARKER);
+    const end = existing.indexOf(END_MARKER);
+    if (start >= 0 && end > start) {
+        const before = existing.slice(0, start).trimEnd();
+        const after = existing.slice(end + END_MARKER.length).trimStart();
+        return `${before}\n\n${block}${after ? `\n${after}` : ""}`;
+    }
+    return `${existing.trimEnd()}\n\n${block}`;
+}
+function writePlan(file, content) {
+    return { file, content };
+}
+async function writeFileEnsured(file, content) {
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, content, "utf8");
+}
+async function readTemplate(relativePath) {
+    return readFile(path.join(packageRoot(), relativePath), "utf8");
+}
+async function readPackageInfo() {
+    const raw = await readFile(path.join(packageRoot(), "package.json"), "utf8");
+    return JSON.parse(raw);
+}
+function packageRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+}
+async function readOptional(file) {
+    try {
+        return await readFile(file, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function readOptionalJson(file) {
+    const raw = await readOptional(file);
+    return raw ? JSON.parse(stripBom(raw)) : undefined;
+}
+function stripBom(value) {
+    return value.charCodeAt(0) === 0xfeff ? value.slice(1) : value;
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

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

package/dist/mcp/server.d.ts

@@ -1 +1,2 @@
+export declare function resolveServerVersion(): Promise<string>;
 export declare function startMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -1,13 +1,22 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import * as z from "zod/v4";
 import { LINK_TYPES, MEMORY_KINDS } from "../constants.js";
 import { connectOrStartDaemon } from "../daemon/client.js";
 import { inferProjectName } from "../memory/project.js";
+// server.ts lives at src/mcp/ (dist/mcp/ once built), so package.json is two levels up.
+export async function resolveServerVersion() {
+    const packageJsonPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
+    const raw = await readFile(packageJsonPath, "utf8");
+    return JSON.parse(raw).version;
+}
 export async function startMcpServer() {
     const server = new McpServer({
         name: "augment",
-        version: "0.1.0",
+        version: await resolveServerVersion(),
     });
     server.registerTool("init_project", {
         description: "Infer or upsert the current project and return its local project record.",