@nram-ai/setup-agents 0.0.1-pre.0

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2026 Brandon Lehmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,109 @@
+<p align="center">
+  <img src="https://nram.ai/brand.png" alt="Neural Ram" width="150" />
+</p>
+
+<h1 align="center">@nram-ai/setup-agents</h1>
+
+<p align="center"><sub>the setup wizard for <a href="https://github.com/nram-ai/nram">Neural Ram</a> (<code>nram</code> for short)</sub></p>
+
+<p align="center">
+  <strong>One command to connect your AI coding tools to Neural Ram.</strong><br />
+  Registers the MCP connection and installs the standing memory instructions for 19 tools, in one interactive run.
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-7FCFFA?style=flat-square" alt="License: MIT" /></a>
+  <a href="https://www.npmjs.com/package/@nram-ai/setup-agents"><img src="https://img.shields.io/npm/v/@nram-ai/setup-agents?style=flat-square&color=7FCFFA" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/Node.js-22%2B-5FA04E?style=flat-square&logo=node.js&logoColor=white" alt="Node.js 22+" />
+  <img src="https://img.shields.io/badge/supports-19_tools-7FCFFA?style=flat-square" alt="Supports 19 tools" />
+  <a href="https://github.com/nram-ai/setup-agents/stargazers"><img src="https://img.shields.io/github/stars/nram-ai/setup-agents?style=flat-square&color=7FCFFA" alt="GitHub stars" /></a>
+  <img src="https://img.shields.io/github/last-commit/nram-ai/setup-agents?style=flat-square&color=7FCFFA" alt="Last commit" />
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> &middot;
+  <a href="#supported-tools">Supported tools</a> &middot;
+  <a href="https://nram.ai">nram.ai</a>
+</p>
+
+> Work in progress: under active development. Expect rough edges, and feedback is welcome.
+
+## Quick Start
+
+```bash
+npx @nram-ai/setup-agents
+```
+
+Neural Ram is the continuity layer for everything you do with AI: one self-hosted server that keeps what mattered across every tool, every conversation, and every machine. This wizard wires your coding tools into it.
+
+Your agents get two things out of it: a connection to your nram server (over MCP), and standing instructions that teach them to actually use it, recalling context at the start of every task and storing what they learn. Without the second half, an agent has memory tools it never thinks to touch; without the first, it has instructions about tools that do not exist. This wizard sets up both.
+
+## Requirements
+
+- Node.js 22 or newer
+- A running [Neural Ram](https://github.com/nram-ai/nram) server (defaults to `http://localhost:8674`)
+
+## What it does
+
+The wizard walks you through five questions and then does the work:
+
+1. **Scope.** User level (your machine-wide tool configs) or project level (files inside the current repository, shareable with your team).
+2. **Tools.** Every supported tool is listed; the ones detected on your machine are preselected. At project level you can configure tools you do not have installed, because teammates might.
+3. **Components.** The MCP connection, the agent instructions, or both (the default).
+4. **Server.** Your nram base URL, asked once and used for both components: the MCP endpoint derives from it, and the canonical agent instructions are pulled from its public `/instructions` endpoint. Pass it up front with `--url` and the wizard notes the value and skips this question. Every run health-checks the server against `/v1/health` before a single file is touched.
+5. **Authentication.** OAuth (recommended: capable tools discover your server and negotiate on their own, this wizard never sees a credential) or an nram API key.
+
+Then it configures each selected tool and prints exactly what it did: every file written, everything skipped because it was already in place, and any step a tool requires you to finish by hand.
+
+## Supported tools
+
+| Tool | MCP connection | Agent instructions |
+|---|---|---|
+| Amp | `settings.json` | `AGENTS.md` |
+| Antigravity | `mcp_config.json` (no MCP OAuth; use an API key) | `AGENTS.md` |
+| Claude Code | `claude mcp add` | SessionStart hook |
+| Codex | `config.toml` | SessionStart hook |
+| Cursor | `mcp.json` | `.cursor/rules/` (project scope) |
+| Droid (Factory) | `mcp.json` | `AGENTS.md` |
+| GitHub Copilot CLI | `mcp-config.json` | `copilot-instructions.md` / `AGENTS.md` |
+| Grok Build (xAI) | `config.toml` | SessionStart hook (project scope needs `/hooks-trust`) |
+| Hermes | `config.yaml` | `AGENTS.md` (project scope) |
+| Junie (JetBrains) | `mcp/mcp.json` | `AGENTS.md` |
+| Kilo Code | `kilo.jsonc` | rules file |
+| Kimi Code | `mcp.json` | not supported by Kimi yet |
+| Kiro | `settings/mcp.json` | steering doc |
+| OpenClaw | `openclaw.json` | workspace `AGENTS.md` |
+| OpenCode | `opencode.json` | `AGENTS.md` |
+| Pi | `mcp.json` | `AGENTS.md` |
+| Trae | through Trae's own MCP UI | rules file (project scope) |
+| Vibe (Mistral) | `config.toml` (a project file is updated, never created) | `AGENTS.md` |
+| VS Code | `.vscode/mcp.json` | instructions file |
+
+Where a tool genuinely cannot do something (a scope it does not support, OAuth it has not implemented, an instructions file it will not read), the wizard says so plainly and prints what to do instead. It never writes a file the tool would ignore.
+
+## How it treats your files
+
+**It merges; it does not overwrite.** Existing config files are edited surgically: a JSON config gains one keyed entry, a TOML or YAML config gains one clearly marked block, and everything else in the file, comments included, survives byte for byte.
+
+**It is idempotent.** Run it twice and the second run changes nothing; every action reports `skipped: already present`. Marker-fenced blocks are updated in place on reruns, never duplicated.
+
+**It refuses rather than guesses.** A config file it cannot parse is left untouched, and you get a copy-paste snippet instead. Same for anything it cannot verify the tool actually supports.
+
+**It keeps secrets off disk.** In API-key mode, configs reference the `NRAM_API_KEY` environment variable wherever the tool supports substitution; where it does not, you are told which header to add yourself. The key itself is never written to a config file.
+
+## Flags
+
+```
+npx @nram-ai/setup-agents [options]
+
+  -u, --url <url>       the base URL of your nram server (skips the prompt)
+  --skip-mcp            do not register the nram MCP server
+  --skip-instructions   do not inject the agent instructions
+  -s, --session-start   fetch and print the agent instructions and exit
+```
+
+`--session-start` is the command the installed SessionStart hooks run (they carry `--url`, so each hook knows your server): its output lands in the agent's context at the start of every session, which keeps the memory protocol out of your CLAUDE.md and AGENTS.md files where hooks are supported, and always current because the text comes from your server, the single source of truth. Every successful fetch is cached at `~/.nram/cache/`; when the server is unreachable the hook serves that cached copy, then the copy in the nram source on GitHub, and as a last resort a short notice telling the agent to let you know the instructions could not be loaded. The hook never fails or blocks a session beyond a few bounded seconds.
+
+## License
+
+MIT

package/dist/helpers/configure/amp.d.ts

@@ -0,0 +1,9 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Configures Amp (Sourcegraph): merges the nram MCP server into settings.json
+ * under the `amp.mcpServers` key and upserts the agent instructions into the
+ * AGENTS.md Amp reads at the requested scope
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_amp: (options: SetupOptions) => Promise<ActionResult[]>;

package/dist/helpers/configure/amp.js

@@ -0,0 +1,49 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure_amp = void 0;
+const path_1 = require("path");
+const paths_1 = require("../paths");
+const upsert_1 = require("../upsert");
+/**
+ * Configures Amp (Sourcegraph): merges the nram MCP server into settings.json
+ * under the `amp.mcpServers` key and upserts the agent instructions into the
+ * AGENTS.md Amp reads at the requested scope
+ *
+ * @param options the collected setup options
+ */
+const configure_amp = async (options) => {
+    const results = [];
+    if (options.mcp_url !== undefined) {
+        const config_path = (0, path_1.resolve)((0, paths_1.amp_dir)(options.scope), 'settings.json');
+        const mcp = (0, upsert_1.mcp_json_result)(config_path, ['amp.mcpServers', 'nram'], { url: options.mcp_url });
+        results.push(mcp);
+        if (mcp.kind !== 'manual' && options.api_key !== undefined) {
+            results.push((0, upsert_1.api_key_header_manual_result)(config_path));
+        }
+    }
+    if (options.instructions) {
+        results.push((0, upsert_1.agents_md_result)((0, paths_1.agents_md_path)(options.scope, (0, path_1.resolve)((0, paths_1.amp_dir)(options.scope), 'AGENTS.md')), options.instructions.full));
+    }
+    return results;
+};
+exports.configure_amp = configure_amp;
+//# sourceMappingURL=amp.js.map

package/dist/helpers/configure/amp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"amp.js","sourceRoot":"","sources":["../../../src/helpers/configure/amp.ts"],"names":[],"mappings":";AAAA,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;AAEZ,+BAA+B;AAE/B,oCAAmD;AACnD,sCAA4F;AAE5F;;;;;;GAMG;AACI,MAAM,aAAa,GAAG,KAAK,EAAE,OAAqB,EAA2B,EAAE;IAClF,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,IAAA,eAAO,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC;QAErE,MAAM,GAAG,GAAG,IAAA,wBAAe,EAAC,WAAW,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/F,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACzD,OAAO,CAAC,IAAI,CAAC,IAAA,qCAA4B,EAAC,WAAW,CAAC,CAAC,CAAC;QAC5D,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,IAAA,yBAAgB,EACzB,IAAA,sBAAc,EAAC,OAAO,CAAC,KAAK,EAAE,IAAA,cAAO,EAAC,IAAA,eAAO,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,EAC3E,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAtBW,QAAA,aAAa,iBAsBxB"}

package/dist/helpers/configure/antigravity.d.ts

@@ -0,0 +1,12 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Configures Google Antigravity: merges the nram MCP server into the
+ * user-level mcp_config.json (Antigravity documents project-local MCP config
+ * as read-but-ignored, and uses `serverUrl` rather than `url`) and upserts
+ * the agent instructions into the AGENTS.md Antigravity reads. AGENTS.md is
+ * used instead of GEMINI.md deliberately: Antigravity and Gemini CLI both
+ * write GEMINI.md, a documented conflict
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_antigravity: (options: SetupOptions) => Promise<ActionResult[]>;

package/dist/helpers/configure/antigravity.js

@@ -0,0 +1,74 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure_antigravity = void 0;
+const path_1 = require("path");
+const types_1 = require("../../types");
+const paths_1 = require("../paths");
+const upsert_1 = require("../upsert");
+/**
+ * Configures Google Antigravity: merges the nram MCP server into the
+ * user-level mcp_config.json (Antigravity documents project-local MCP config
+ * as read-but-ignored, and uses `serverUrl` rather than `url`) and upserts
+ * the agent instructions into the AGENTS.md Antigravity reads. AGENTS.md is
+ * used instead of GEMINI.md deliberately: Antigravity and Gemini CLI both
+ * write GEMINI.md, a documented conflict
+ *
+ * @param options the collected setup options
+ */
+const configure_antigravity = async (options) => {
+    const results = [];
+    if (options.mcp_url !== undefined) {
+        if (options.scope !== types_1.Scope.USER) {
+            results.push({
+                action: 'MCP registration',
+                kind: 'skipped',
+                detail: 'Antigravity documents project-local MCP config as read-but-ignored; ' +
+                    'rerun at user scope to register the server'
+            });
+        }
+        else {
+            const config_path = (0, path_1.resolve)((0, paths_1.antigravity_dir)(), 'mcp_config.json');
+            const mcp = (0, upsert_1.mcp_json_result)(config_path, ['mcpServers', 'nram'], { serverUrl: options.mcp_url });
+            results.push(mcp);
+            if (mcp.kind !== 'manual') {
+                if (options.api_key !== undefined) {
+                    results.push((0, upsert_1.api_key_header_manual_result)(config_path));
+                }
+                else {
+                    results.push({
+                        action: 'Authentication',
+                        kind: 'manual',
+                        detail: 'Antigravity does not support MCP OAuth (as of June 2026), and nram requires ' +
+                            'authentication; create an nram API key and add it as an Authorization header in ' +
+                            `${config_path}, or rerun this tool choosing API-key authentication`
+                    });
+                }
+            }
+        }
+    }
+    if (options.instructions) {
+        results.push((0, upsert_1.agents_md_result)((0, paths_1.agents_md_path)(options.scope, (0, path_1.resolve)((0, paths_1.gemini_dir)(), 'AGENTS.md')), options.instructions.full));
+    }
+    return results;
+};
+exports.configure_antigravity = configure_antigravity;
+//# sourceMappingURL=antigravity.js.map

package/dist/helpers/configure/antigravity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"antigravity.js","sourceRoot":"","sources":["../../../src/helpers/configure/antigravity.ts"],"names":[],"mappings":";AAAA,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;AAEZ,+BAA+B;AAC/B,uCAAgE;AAChE,oCAAuE;AACvE,sCAA4F;AAE5F;;;;;;;;;GASG;AACI,MAAM,qBAAqB,GAAG,KAAK,EAAE,OAAqB,EAA2B,EAAE;IAC1F,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,KAAK,KAAK,aAAK,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,sEAAsE;oBAC1E,4CAA4C;aACnD,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,IAAA,uBAAe,GAAE,EAAE,iBAAiB,CAAC,CAAC;YAElE,MAAM,GAAG,GAAG,IAAA,wBAAe,EAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAEjG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAElB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAChC,OAAO,CAAC,IAAI,CAAC,IAAA,qCAA4B,EAAC,WAAW,CAAC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,IAAI,CAAC;wBACT,MAAM,EAAE,gBAAgB;wBACxB,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,8EAA8E;4BAClF,kFAAkF;4BAClF,GAAG,WAAW,sDAAsD;qBAC3E,CAAC,CAAC;gBACP,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,IAAA,yBAAgB,EACzB,IAAA,sBAAc,EAAC,OAAO,CAAC,KAAK,EAAE,IAAA,cAAO,EAAC,IAAA,kBAAU,GAAE,EAAE,WAAW,CAAC,CAAC,EACjE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAzCW,QAAA,qBAAqB,yBAyChC"}

package/dist/helpers/configure/claude_code.d.ts

@@ -0,0 +1,9 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Configures Claude Code: registers the nram MCP server via the documented
+ * `claude mcp add` CLI and injects the agent-instructions SessionStart hook
+ * into settings.json at the requested scope
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_claude_code: (options: SetupOptions) => Promise<ActionResult[]>;

package/dist/helpers/configure/claude_code.js

@@ -0,0 +1,119 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure_claude_code = void 0;
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+const types_1 = require("../../types");
+const paths_1 = require("../paths");
+const upsert_1 = require("../upsert");
+/**
+ * Runs the `claude` CLI with the supplied arguments
+ *
+ * On Windows the CLI is commonly an `.exe` or an npm `.cmd` shim; the latter
+ * is only executable through a shell, so we shell out there and quote each
+ * argument ourselves (callers must never pass arguments containing `"`)
+ *
+ * @param args the CLI arguments
+ */
+const run_claude = (args) => {
+    const use_shell = process.platform === 'win32';
+    const final_args = use_shell ? args.map(arg => `"${arg}"`) : args;
+    const result = (0, child_process_1.spawnSync)('claude', final_args, {
+        shell: use_shell,
+        encoding: 'utf8',
+        windowsHide: true,
+        timeout: 30_000
+    });
+    const missing = result.error !== undefined || result.status === null;
+    return {
+        ok: result.status === 0,
+        missing,
+        output: `${result.stdout ?? ''}${result.stderr ?? ''}`.trim()
+    };
+};
+/**
+ * Registers the nram MCP server via the documented `claude mcp add` CLI,
+ * guarded by `claude mcp get nram` so re-runs never double-add
+ *
+ * @param scope the CLI scope flag value
+ * @param mcp_url the MCP endpoint URL
+ * @param api_key the API key, when API-key authentication was chosen
+ */
+const claude_mcp_result = (scope, mcp_url, api_key) => {
+    const add_args = ['mcp', 'add', '--scope', scope, '--transport', 'http', 'nram', mcp_url];
+    if (api_key !== undefined) {
+        add_args.push('--header', `Authorization: Bearer ${api_key}`);
+    }
+    const manual_command = `claude ${add_args.join(' ')}`;
+    if (add_args.some(arg => arg.includes('"'))) {
+        return {
+            action: 'MCP registration',
+            kind: 'failed',
+            detail: 'refusing to run: argument contains a double quote'
+        };
+    }
+    const existing = run_claude(['mcp', 'get', 'nram']);
+    if (existing.missing) {
+        return {
+            action: 'MCP registration',
+            kind: 'manual',
+            detail: `the claude CLI was not found on PATH; run this yourself: ${manual_command}`
+        };
+    }
+    if (existing.ok) {
+        return {
+            action: 'MCP registration',
+            kind: 'skipped',
+            detail: 'an MCP server named "nram" is already registered (claude mcp get nram)'
+        };
+    }
+    const added = run_claude(add_args);
+    if (added.ok) {
+        return { action: 'MCP registration', kind: 'written', detail: manual_command };
+    }
+    return {
+        action: 'MCP registration',
+        kind: 'failed',
+        detail: `claude mcp add failed: ${added.output || 'unknown error'}; ` +
+            `run this yourself: ${manual_command}`
+    };
+};
+/**
+ * Configures Claude Code: registers the nram MCP server via the documented
+ * `claude mcp add` CLI and injects the agent-instructions SessionStart hook
+ * into settings.json at the requested scope
+ *
+ * @param options the collected setup options
+ */
+const configure_claude_code = async (options) => {
+    const results = [];
+    if (options.mcp_url !== undefined) {
+        const scope = options.scope === types_1.Scope.USER ? 'user' : 'project';
+        results.push(claude_mcp_result(scope, options.mcp_url, options.api_key));
+    }
+    if (options.instructions) {
+        results.push((0, upsert_1.upsert_hooks_json)((0, path_1.resolve)((0, paths_1.claude_dir)(options.scope), 'settings.json'), options.base_url));
+    }
+    return results;
+};
+exports.configure_claude_code = configure_claude_code;
+//# sourceMappingURL=claude_code.js.map

package/dist/helpers/configure/claude_code.js.map

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

package/dist/helpers/configure/codex.d.ts

@@ -0,0 +1,19 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Builds the marker-fenced `[mcp_servers.nram]` TOML block. In API-key mode
+ * the key itself is never written to disk; the file references the
+ * NRAM_API_KEY environment variable instead
+ *
+ * @param mcp_url the MCP endpoint URL
+ * @param api_key the API key, when API-key authentication was chosen
+ */
+export declare const codex_mcp_block: (mcp_url: string, api_key?: string) => string;
+/**
+ * Configures Codex: upserts a marker-fenced `[mcp_servers.nram]` block in
+ * config.toml (the `codex mcp add` CLI covers stdio servers only, so remote
+ * HTTP servers are written to the file, per the Codex docs) and injects the
+ * agent-instructions SessionStart hook into hooks.json
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_codex: (options: SetupOptions) => Promise<ActionResult[]>;

package/dist/helpers/configure/codex.js

@@ -0,0 +1,76 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure_codex = exports.codex_mcp_block = void 0;
+const path_1 = require("path");
+const smol_toml_1 = require("smol-toml");
+const paths_1 = require("../paths");
+const upsert_1 = require("../upsert");
+/**
+ * Builds the marker-fenced `[mcp_servers.nram]` TOML block. In API-key mode
+ * the key itself is never written to disk; the file references the
+ * NRAM_API_KEY environment variable instead
+ *
+ * @param mcp_url the MCP endpoint URL
+ * @param api_key the API key, when API-key authentication was chosen
+ */
+const codex_mcp_block = (mcp_url, api_key) => {
+    const lines = [
+        '[mcp_servers.nram]',
+        `url = "${mcp_url}"`
+    ];
+    if (api_key !== undefined) {
+        lines.push('bearer_token_env_var = "NRAM_API_KEY"');
+    }
+    return lines.join('\n');
+};
+exports.codex_mcp_block = codex_mcp_block;
+/**
+ * Configures Codex: upserts a marker-fenced `[mcp_servers.nram]` block in
+ * config.toml (the `codex mcp add` CLI covers stdio servers only, so remote
+ * HTTP servers are written to the file, per the Codex docs) and injects the
+ * agent-instructions SessionStart hook into hooks.json
+ *
+ * @param options the collected setup options
+ */
+const configure_codex = async (options) => {
+    const results = [];
+    if (options.mcp_url !== undefined) {
+        const config_path = (0, path_1.resolve)((0, paths_1.codex_dir)(options.scope), 'config.toml');
+        const mcp = (0, upsert_1.upsert_block_with_validation)(config_path, (0, exports.codex_mcp_block)(options.mcp_url, options.api_key), smol_toml_1.parse, 'TOML', (parsed, text) => parsed?.mcp_servers?.nram !== undefined && !(0, upsert_1.has_marker_block)(text, 'hash')
+            ? {
+                action: 'MCP registration',
+                kind: 'skipped',
+                detail: `[mcp_servers.nram] already exists in ${config_path} (outside the nram setup markers)`
+            }
+            : undefined, parsed => parsed?.mcp_servers?.nram !== undefined);
+        results.push(mcp);
+        if ((mcp.kind === 'written' || mcp.kind === 'updated') && options.api_key !== undefined) {
+            results.push((0, upsert_1.api_key_manual_result)());
+        }
+    }
+    if (options.instructions) {
+        results.push((0, upsert_1.upsert_hooks_json)((0, path_1.resolve)((0, paths_1.codex_dir)(options.scope), 'hooks.json'), options.base_url));
+    }
+    return results;
+};
+exports.configure_codex = configure_codex;
+//# sourceMappingURL=codex.js.map

package/dist/helpers/configure/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/helpers/configure/codex.ts"],"names":[],"mappings":";AAAA,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;AAEZ,+BAA+B;AAC/B,yCAAkC;AAElC,oCAAqC;AACrC,sCAKmB;AAEnB;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,OAAgB,EAAU,EAAE;IACzE,MAAM,KAAK,GAAG;QACV,oBAAoB;QACpB,UAAU,OAAO,GAAG;KACvB,CAAC;IAEF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC,CAAC;AAXW,QAAA,eAAe,mBAW1B;AAEF;;;;;;;GAOG;AACI,MAAM,eAAe,GAAG,KAAK,EAAE,OAAqB,EAA2B,EAAE;IACpF,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,IAAA,iBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;QAErE,MAAM,GAAG,GAAG,IAAA,qCAA4B,EACpC,WAAW,EACX,IAAA,uBAAe,EAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACjD,iBAAK,EACL,MAAM,EACN,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,IAAA,yBAAgB,EAAC,IAAI,EAAE,MAAM,CAAC;YACxF,CAAC,CAAC;gBACE,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,wCAAwC,WAAW,mCAAmC;aACjG;YACD,CAAC,CAAC,SAAS,EACf,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,SAAS,CACpD,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElB,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,IAAA,8BAAqB,GAAE,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,IAAA,0BAAiB,EAAC,IAAA,cAAO,EAAC,IAAA,iBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvG,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAjCW,QAAA,eAAe,mBAiC1B"}

package/dist/helpers/configure/copilot.d.ts

@@ -0,0 +1,11 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Configures GitHub Copilot CLI: merges the nram MCP server into the
+ * user-level mcp-config.json (Copilot CLI has no repo-level MCP config) and
+ * upserts the agent instructions into the files Copilot CLI documents:
+ * `$HOME/.copilot/copilot-instructions.md` at user scope and the repository
+ * root AGENTS.md at project scope
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_copilot: (options: SetupOptions) => Promise<ActionResult[]>;

package/dist/helpers/configure/copilot.js

@@ -0,0 +1,64 @@
+"use strict";
+// Copyright (c) 2026, Brandon Lehmann <brandonlehmann@gmail.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configure_copilot = void 0;
+const path_1 = require("path");
+const types_1 = require("../../types");
+const paths_1 = require("../paths");
+const upsert_1 = require("../upsert");
+/**
+ * Configures GitHub Copilot CLI: merges the nram MCP server into the
+ * user-level mcp-config.json (Copilot CLI has no repo-level MCP config) and
+ * upserts the agent instructions into the files Copilot CLI documents:
+ * `$HOME/.copilot/copilot-instructions.md` at user scope and the repository
+ * root AGENTS.md at project scope
+ *
+ * @param options the collected setup options
+ */
+const configure_copilot = async (options) => {
+    const results = [];
+    if (options.mcp_url !== undefined) {
+        if (options.scope !== types_1.Scope.USER) {
+            results.push({
+                action: 'MCP registration',
+                kind: 'skipped',
+                detail: 'Copilot CLI stores MCP servers in the user-level mcp-config.json only; rerun at user scope'
+            });
+        }
+        else {
+            const config_path = (0, path_1.resolve)((0, paths_1.copilot_dir)(), 'mcp-config.json');
+            const mcp = (0, upsert_1.mcp_json_result)(config_path, ['servers', 'nram'], {
+                type: 'http',
+                url: options.mcp_url
+            });
+            results.push(mcp);
+            if (mcp.kind !== 'manual' && options.api_key !== undefined) {
+                results.push((0, upsert_1.api_key_header_manual_result)(config_path));
+            }
+        }
+    }
+    if (options.instructions) {
+        results.push((0, upsert_1.agents_md_result)((0, paths_1.agents_md_path)(options.scope, (0, path_1.resolve)((0, paths_1.copilot_dir)(), 'copilot-instructions.md')), options.instructions.full));
+    }
+    return results;
+};
+exports.configure_copilot = configure_copilot;
+//# sourceMappingURL=copilot.js.map

package/dist/helpers/configure/copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.js","sourceRoot":"","sources":["../../../src/helpers/configure/copilot.ts"],"names":[],"mappings":";AAAA,iEAAiE;AACjE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AACxE,2DAA2D;AAC3D,EAAE;AACF,iFAAiF;AACjF,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,8EAA8E;AAC9E,yEAAyE;AACzE,gFAAgF;AAChF,gFAAgF;AAChF,YAAY;;;AAEZ,+BAA+B;AAC/B,uCAAgE;AAChE,oCAAuD;AACvD,sCAA4F;AAE5F;;;;;;;;GAQG;AACI,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAqB,EAA2B,EAAE;IACtF,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,KAAK,KAAK,aAAK,CAAC,IAAI,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,kBAAkB;gBAC1B,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,4FAA4F;aACvG,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,IAAA,mBAAW,GAAE,EAAE,iBAAiB,CAAC,CAAC;YAE9D,MAAM,GAAG,GAAG,IAAA,wBAAe,EAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE;gBAC1D,IAAI,EAAE,MAAM;gBACZ,GAAG,EAAE,OAAO,CAAC,OAAO;aACvB,CAAC,CAAC;YAEH,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAElB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACzD,OAAO,CAAC,IAAI,CAAC,IAAA,qCAA4B,EAAC,WAAW,CAAC,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,IAAA,yBAAgB,EACzB,IAAA,sBAAc,EAAC,OAAO,CAAC,KAAK,EAAE,IAAA,cAAO,EAAC,IAAA,mBAAW,GAAE,EAAE,yBAAyB,CAAC,CAAC,EAChF,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC,CAAC;AAjCW,QAAA,iBAAiB,qBAiC5B"}

package/dist/helpers/configure/cursor.d.ts

@@ -0,0 +1,26 @@
+import { ActionResult, SetupOptions } from '../../types';
+/**
+ * Builds the `mcpServers.nram` entry for Cursor's mcp.json. In API-key mode
+ * the key is referenced through Cursor's `${env:...}` interpolation, never
+ * written to disk
+ *
+ * @param mcp_url the MCP endpoint URL
+ * @param api_key the API key, when API-key authentication was chosen
+ */
+export declare const cursor_mcp_entry: (mcp_url: string, api_key?: string) => any;
+/**
+ * Builds the project rule file (`.cursor/rules/nram.mdc`) carrying the agent
+ * instructions; `alwaysApply: true` injects it into every Agent conversation
+ *
+ * @param instructions the agent instructions text
+ */
+export declare const cursor_rule_file: (instructions: string) => string;
+/**
+ * Configures Cursor: merges the nram MCP server into mcp.json and, at project
+ * scope, writes the agent instructions as `.cursor/rules/nram.mdc`
+ * (`.cursorrules` is deprecated; user-level rules live only in the Cursor
+ * settings GUI, so the instruction half is reported and skipped at user scope)
+ *
+ * @param options the collected setup options
+ */
+export declare const configure_cursor: (options: SetupOptions) => Promise<ActionResult[]>;