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

package/dist/helpers/url.js

@@ -0,0 +1,51 @@
+"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.mcp_url = exports.normalize_base_url = void 0;
+/**
+ * Normalizes an nram base URL: trims whitespace, requires http/https,
+ * and strips any trailing slash so that paths can be appended safely
+ *
+ * @param input the user-supplied base URL
+ * @returns the normalized base URL
+ * @throws Error when the input is not a valid http(s) URL
+ */
+const normalize_base_url = (input) => {
+    const trimmed = input.trim();
+    const url = new URL(trimmed); // throws on invalid input
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error('The nram base URL must use http or https');
+    }
+    if (url.search.length !== 0 || url.hash.length !== 0) {
+        throw new Error('The nram base URL must not contain a query string or fragment');
+    }
+    const pathname = url.pathname.replace(/\/+$/, '');
+    return `${url.origin}${pathname}`;
+};
+exports.normalize_base_url = normalize_base_url;
+/**
+ * Derives the MCP endpoint URL from a normalized base URL
+ *
+ * @param base_url the normalized nram base URL
+ */
+const mcp_url = (base_url) => `${base_url}/mcp`;
+exports.mcp_url = mcp_url;
+//# sourceMappingURL=url.js.map

package/dist/helpers/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/helpers/url.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;;;;;;;GAOG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAU,EAAE;IACxD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;IAExD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAElD,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;AACtC,CAAC,CAAC;AAhBW,QAAA,kBAAkB,sBAgB7B;AAEF;;;;GAIG;AACI,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,GAAG,QAAQ,MAAM,CAAC;AAA1D,QAAA,OAAO,WAAmD"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+"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.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const instructions_1 = require("./helpers/instructions");
+const url_1 = require("./helpers/url");
+commander_1.program.name('npx @nram-ai/setup-agents')
+    .description('Helps to configure local harnesses to utilize Neural Ram');
+commander_1.program.option('-s, --session-start', 'print out the session start protocol');
+commander_1.program.option('-u, --url <url>', 'the base URL of your nram server (skips the prompt)');
+commander_1.program.option('--skip-mcp', 'do not register the nram MCP server');
+commander_1.program.option('--skip-instructions', 'do not inject the agent instructions (hook, AGENTS.md, or rules file)');
+commander_1.program.parse();
+const options = commander_1.program.opts();
+if (options.sessionStart) {
+    // A SessionStart hook must never break an agent session: any failure
+    // falls down the chain (server, cache, GitHub, built-in notice) and the
+    // process always exits 0
+    (async () => {
+        let base_url;
+        try {
+            base_url = options.url !== undefined ? (0, url_1.normalize_base_url)(options.url) : undefined;
+        }
+        catch {
+            // an unparseable --url degrades to the cache/GitHub chain
+        }
+        try {
+            const { text } = await (0, instructions_1.resolve_instructions)(base_url, 'full', 3_000);
+            console.log(text);
+        }
+        catch {
+            console.log((0, instructions_1.builtin_notice)('full'));
+        }
+        process.exit(0);
+    })();
+}
+else {
+    // The interactive flow (and its dependencies: @clack/prompts, chalk, and
+    // smol-toml via the configurators) loads lazily so the --session-start
+    // fast path above, which runs at every agent session start, stays cheap
+    (async () => {
+        const { run_setup } = await Promise.resolve().then(() => __importStar(require('./setup')));
+        await run_setup({
+            skip_mcp: options.skipMcp === true,
+            skip_instructions: options.skipInstructions === true,
+            url: options.url
+        });
+    })().catch((error) => {
+        console.error(error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAEA,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,yCAAoC;AACpC,yDAA8E;AAC9E,uCAAmD;AAEnD,mBAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC;KACpC,WAAW,CAAC,0DAA0D,CAAC,CAAC;AAE7E,mBAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,sCAAsC,CAAC,CAAC;AAC9E,mBAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,qDAAqD,CAAC,CAAC;AACzF,mBAAO,CAAC,MAAM,CAAC,YAAY,EAAE,qCAAqC,CAAC,CAAC;AACpE,mBAAO,CAAC,MAAM,CAAC,qBAAqB,EAAE,uEAAuE,CAAC,CAAC;AAC/G,mBAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,MAAM,OAAO,GAAG,mBAAO,CAAC,IAAI,EAAE,CAAC;AAE/B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,qEAAqE;IACrE,wEAAwE;IACxE,yBAAyB;IACzB,CAAC,KAAK,IAAI,EAAE;QACR,IAAI,QAA4B,CAAC;QAEjC,IAAI,CAAC;YACD,QAAQ,GAAG,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,wBAAkB,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACL,0DAA0D;QAC9D,CAAC;QAED,IAAI,CAAC;YACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,mCAAoB,EAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAErE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAc,EAAC,MAAM,CAAC,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;KAAM,CAAC;IACJ,yEAAyE;IACzE,uEAAuE;IACvE,wEAAwE;IACxE,CAAC,KAAK,IAAI,EAAE;QACR,MAAM,EAAE,SAAS,EAAE,GAAG,wDAAa,SAAS,GAAC,CAAC;QAE9C,MAAM,SAAS,CAAC;YACZ,QAAQ,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI;YAClC,iBAAiB,EAAE,OAAO,CAAC,gBAAgB,KAAK,IAAI;YACpD,GAAG,EAAE,OAAO,CAAC,GAAG;SACnB,CAAC,CAAC;IACP,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;QACtB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Flags that pre-decide (and therefore remove) interactive choices
+ */
+export interface SetupFlags {
+    skip_mcp?: boolean;
+    skip_instructions?: boolean;
+    /** pre-answers the server question; the base URL prompt is skipped */
+    url?: string;
+}
+/**
+ * Runs the interactive setup flow: scope, harness, and component selection,
+ * nram server details, authentication choice, and the per-harness
+ * configurators
+ *
+ * @param flags component choices pre-decided on the command line
+ */
+export declare const run_setup: (flags?: SetupFlags) => Promise<void>;

package/dist/setup.js

@@ -0,0 +1,296 @@
+"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.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run_setup = void 0;
+const prompts_1 = require("@clack/prompts");
+const chalk_1 = __importDefault(require("chalk"));
+const harnesses_1 = require("./helpers/harnesses");
+const instructions_1 = require("./helpers/instructions");
+const url_1 = require("./helpers/url");
+const types_1 = require("./types");
+/**
+ * Unwraps a clack prompt result, exiting cleanly if the user cancelled
+ *
+ * @param value the prompt result
+ */
+const guard = (value) => {
+    if ((0, prompts_1.isCancel)(value)) {
+        (0, prompts_1.cancel)('Setup aborted');
+        process.exit(0);
+    }
+    return value;
+};
+/**
+ * Asks whether to continue past a failed verification, aborting unless the
+ * user explicitly opts in
+ *
+ * @param message the confirmation message
+ */
+const confirm_or_abort = async (message) => {
+    const proceed = guard(await (0, prompts_1.confirm)({ message, initialValue: false }));
+    if (!proceed) {
+        (0, prompts_1.cancel)('Setup aborted');
+        process.exit(1);
+    }
+};
+const KIND_COLORS = {
+    written: chalk_1.default.green,
+    updated: chalk_1.default.cyan,
+    skipped: chalk_1.default.yellow,
+    manual: chalk_1.default.magenta,
+    failed: chalk_1.default.red
+};
+/**
+ * Renders a configurator's results beneath its harness label
+ *
+ * @param label the harness label
+ * @param results the configurator results
+ */
+const render_results = (label, results) => {
+    const lines = results.map(result => `${KIND_COLORS[result.kind](result.kind.padEnd(7))} ${result.action}: ${result.detail}`);
+    prompts_1.log.message(`${chalk_1.default.bold(label)}\n${lines.join('\n')}`);
+};
+/**
+ * Runs the interactive setup flow: scope, harness, and component selection,
+ * nram server details, authentication choice, and the per-harness
+ * configurators
+ *
+ * @param flags component choices pre-decided on the command line
+ */
+const run_setup = async (flags = {}) => {
+    if (flags.skip_mcp && flags.skip_instructions) {
+        console.error('Nothing to configure: both --skip-mcp and --skip-instructions were given.');
+        process.exit(1);
+    }
+    // Validate a command-line URL before any prompts so a typo fails fast
+    // instead of after the user has answered every question
+    let preset_url;
+    if (flags.url !== undefined) {
+        try {
+            preset_url = (0, url_1.normalize_base_url)(flags.url);
+        }
+        catch (error) {
+            console.error(`Invalid --url "${flags.url}": ${error.message}`);
+            process.exit(1);
+        }
+    }
+    (0, prompts_1.intro)(chalk_1.default.bold('@nram-ai/setup-agents'));
+    const scope = guard(await (0, prompts_1.select)({
+        message: 'Configure at which level?',
+        options: [
+            { value: types_1.Scope.USER, label: 'User level', hint: 'your account-wide configuration' },
+            { value: types_1.Scope.PROJECT, label: 'Project level', hint: 'this directory, shared via the repository' }
+        ],
+        initialValue: types_1.Scope.USER
+    }));
+    const detected = new Map(harnesses_1.HARNESSES.map(descriptor => [descriptor.harness, descriptor.detected(scope)]));
+    if (scope === types_1.Scope.USER && ![...detected.values()].some(found => found)) {
+        (0, prompts_1.cancel)('No supported harnesses were detected at the user level. ' +
+            `Install one (${harnesses_1.HARNESSES.map(descriptor => descriptor.label).join(', ')}) ` +
+            'or rerun with project-level scope.');
+        process.exit(1);
+    }
+    const selected = guard(await (0, prompts_1.multiselect)({
+        message: 'Which tools would you like to configure to work with nram?',
+        options: harnesses_1.HARNESSES.map(descriptor => ({
+            value: descriptor.harness,
+            label: descriptor.label,
+            hint: detected.get(descriptor.harness)
+                ? 'detected'
+                : scope === types_1.Scope.PROJECT ? 'not detected here; can be configured anyway' : 'not detected',
+            disabled: scope === types_1.Scope.USER && !detected.get(descriptor.harness)
+        })),
+        initialValues: harnesses_1.HARNESSES.filter(descriptor => detected.get(descriptor.harness))
+            .map(descriptor => descriptor.harness),
+        required: true
+    }));
+    const available = [];
+    if (!flags.skip_mcp) {
+        available.push({
+            value: 'mcp',
+            label: 'MCP server connection',
+            hint: 'register nram as an MCP server'
+        });
+    }
+    if (!flags.skip_instructions) {
+        available.push({
+            value: 'instructions',
+            label: 'Agent instructions',
+            hint: 'SessionStart hook, AGENTS.md, or rules file'
+        });
+    }
+    const components = available.length === 1
+        ? available.map(option => option.value)
+        : guard(await (0, prompts_1.multiselect)({
+            message: 'What should be configured?',
+            options: available,
+            initialValues: available.map(option => option.value),
+            required: true
+        }));
+    const wants_mcp = components.includes('mcp');
+    const wants_instructions = components.includes('instructions');
+    // The base URL now serves both components: the MCP endpoint derives from
+    // it, and the canonical agent instructions are fetched from it
+    let base_url;
+    if (preset_url !== undefined) {
+        base_url = preset_url;
+        prompts_1.log.info(`Using the nram server at ${base_url} (provided via --url)`);
+    }
+    else {
+        base_url = (0, url_1.normalize_base_url)(guard(await (0, prompts_1.text)({
+            message: 'What is the base URL of your nram server?',
+            initialValue: 'http://localhost:8674',
+            validate: (value) => {
+                try {
+                    (0, url_1.normalize_base_url)(value ?? '');
+                }
+                catch (error) {
+                    return error.message;
+                }
+            }
+        })));
+    }
+    // The URL is baked into hook commands and used for the instructions
+    // fetch even without MCP, so verify it on every run; a typo'd URL must
+    // hit this gate rather than quietly riding the fallback chain
+    const health = (0, prompts_1.spinner)();
+    health.start(`Checking ${base_url}/v1/health`);
+    let healthy = false;
+    try {
+        const response = await fetch(`${base_url}/v1/health`, { signal: AbortSignal.timeout(7_000) });
+        healthy = response.ok;
+        health.stop(healthy
+            ? `nram is reachable at ${base_url}`
+            : `nram responded with HTTP ${response.status} at ${base_url}/v1/health`);
+    }
+    catch (error) {
+        health.stop(`Could not reach ${base_url}/v1/health: ${error.message}`);
+    }
+    if (!healthy) {
+        await confirm_or_abort('The nram server could not be verified. Continue writing configuration anyway?');
+    }
+    let mcp_endpoint;
+    let api_key;
+    if (wants_mcp) {
+        mcp_endpoint = (0, url_1.mcp_url)(base_url);
+        const auth = guard(await (0, prompts_1.select)({
+            message: 'How should your tools authenticate to nram?',
+            options: [
+                { value: 'oauth', label: 'OAuth', hint: 'recommended; tools negotiate automatically via discovery' },
+                { value: 'api-key', label: 'API key', hint: 'a nram_k_ key used as a Bearer token' }
+            ],
+            initialValue: 'oauth'
+        }));
+        if (auth === 'api-key') {
+            api_key = guard(await (0, prompts_1.password)({
+                message: 'Paste your nram API key',
+                validate: (value) => {
+                    if (!/^nram_k_[0-9a-zA-Z]+$/.test(value ?? '')) {
+                        return 'That does not look like an nram API key (expected the nram_k_ prefix)';
+                    }
+                }
+            }));
+            const check = (0, prompts_1.spinner)();
+            check.start('Verifying the API key');
+            let verified = false;
+            try {
+                const response = await fetch(`${base_url}/userinfo`, {
+                    headers: { Authorization: `Bearer ${api_key}` },
+                    signal: AbortSignal.timeout(7_000)
+                });
+                verified = response.ok;
+                check.stop(verified ? 'API key verified' : `The key was rejected (HTTP ${response.status})`);
+            }
+            catch (error) {
+                check.stop(`Could not verify the API key: ${error.message}`);
+            }
+            if (!verified) {
+                await confirm_or_abort('The API key could not be verified. Continue anyway?');
+            }
+        }
+    }
+    let instructions;
+    if (wants_instructions) {
+        const fetching = (0, prompts_1.spinner)();
+        fetching.start(`Fetching the canonical agent instructions from ${base_url}`);
+        const [full, condensed] = await Promise.all([
+            (0, instructions_1.resolve_instructions)(base_url, 'full', 7_000),
+            (0, instructions_1.resolve_instructions)(base_url, 'condensed', 7_000)
+        ]);
+        instructions = { full: full.text, condensed: condensed.text };
+        if (full.source === 'server' && condensed.source === 'server') {
+            fetching.stop(`Canonical agent instructions fetched from ${base_url}`);
+        }
+        else {
+            fetching.stop(`The canonical agent instructions could not be fetched from ${base_url}`);
+            const describe = {
+                server: 'the server',
+                cache: 'the last copy cached on this machine',
+                github: 'the fallback copy on GitHub',
+                builtin: 'a built-in notice (the canonical text was unreachable everywhere)'
+            };
+            prompts_1.log.warn(full.source === condensed.source
+                ? `Using ${describe[full.source]} for the agent instructions and the condensed rules.`
+                : `Using ${describe[full.source]} for the agent instructions and ` +
+                    `${describe[condensed.source]} for the condensed rules.`);
+        }
+    }
+    const setup = { scope, base_url, mcp_url: mcp_endpoint, api_key, instructions };
+    let failures = 0;
+    let changes = 0;
+    for (const descriptor of harnesses_1.HARNESSES.filter(descriptor => selected.includes(descriptor.harness))) {
+        const progress = (0, prompts_1.spinner)();
+        progress.start(`Configuring ${descriptor.label}`);
+        try {
+            const results = await descriptor.configure(setup);
+            const written = results.filter(result => result.kind === 'written' || result.kind === 'updated').length;
+            progress.stop(written !== 0 ? `${descriptor.label} configured` : `${descriptor.label}: no changes`);
+            failures += results.filter(result => result.kind === 'failed').length;
+            changes += written;
+            render_results(descriptor.label, results);
+        }
+        catch (error) {
+            progress.stop(`${descriptor.label} failed: ${error.message}`);
+            failures++;
+        }
+    }
+    let done_message;
+    if (failures !== 0) {
+        done_message = chalk_1.default.red('Completed with failures; review the output above.');
+    }
+    else if (changes === 0) {
+        done_message = 'No changes were made; everything selected was already configured or not applicable.';
+    }
+    else if (wants_mcp) {
+        done_message = 'Done. Restart your agent sessions to pick up the changes. ' +
+            'OAuth-capable tools will prompt to authenticate on first use (Claude Code: run /mcp).';
+    }
+    else {
+        done_message = 'Done. Restart your agent sessions to pick up the changes.';
+    }
+    (0, prompts_1.outro)(done_message);
+    process.exitCode = failures === 0 ? 0 : 1;
+};
+exports.run_setup = run_setup;
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export declare enum Harness {
+    ANTHROPIC_CLAUDE_CODE = 1,
+    OPENAI_CODEX = 2,
+    OPENCODE = 3,
+    CURSOR = 4,
+    AMP = 5,
+    OPENCLAW = 6,
+    GITHUB_COPILOT_CLI = 7,
+    FACTORY_DROID = 8,
+    HERMES = 9,
+    JETBRAINS_JUNIE = 10,
+    KILO_CODE = 11,
+    KIRO = 12,
+    PI = 13,
+    TRAE = 14,
+    VSCODE = 15,
+    GOOGLE_ANTIGRAVITY = 16,
+    KIMI_CODE = 17,
+    MISTRAL_VIBE = 18,
+    XAI_GROK_BUILD = 19
+}
+export declare enum Scope {
+    USER = 1,
+    PROJECT = 2
+}
+/**
+ * The options collected from the user that drive every harness configurator
+ */
+export interface SetupOptions {
+    scope: Scope;
+    /** The normalized nram base URL; embedded into SessionStart hook commands */
+    base_url: string;
+    /** The MCP endpoint URL; undefined when MCP registration was not requested */
+    mcp_url?: string;
+    /** Present only when the user chose API-key authentication */
+    api_key?: string;
+    /**
+     * The agent instructions to inject (SessionStart hook, AGENTS.md, or
+     * rules file), resolved from the server; undefined when not requested.
+     * `full` feeds AGENTS.md-style embeds, `condensed` the always-injected
+     * surfaces (rules files, steering docs)
+     */
+    instructions?: {
+        full: string;
+        condensed: string;
+    };
+}
+export type ActionKind = 'written' | 'updated' | 'skipped' | 'manual' | 'failed';
+/**
+ * The outcome of a single configuration action taken (or not taken) by a configurator
+ */
+export interface ActionResult {
+    /** Short action name, e.g. `MCP registration` */
+    action: string;
+    kind: ActionKind;
+    /** The file path, command, or manual instruction the user needs to see */
+    detail: string;
+}
+/**
+ * Describes a supported harness: how to detect it and how to configure it
+ */
+export interface HarnessDescriptor {
+    harness: Harness;
+    label: string;
+    detected: (scope: Scope) => boolean;
+    configure: (options: SetupOptions) => Promise<ActionResult[]>;
+}

package/dist/types.js

@@ -0,0 +1,50 @@
+"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.Scope = exports.Harness = void 0;
+var Harness;
+(function (Harness) {
+    Harness[Harness["ANTHROPIC_CLAUDE_CODE"] = 1] = "ANTHROPIC_CLAUDE_CODE";
+    Harness[Harness["OPENAI_CODEX"] = 2] = "OPENAI_CODEX";
+    Harness[Harness["OPENCODE"] = 3] = "OPENCODE";
+    Harness[Harness["CURSOR"] = 4] = "CURSOR";
+    Harness[Harness["AMP"] = 5] = "AMP";
+    Harness[Harness["OPENCLAW"] = 6] = "OPENCLAW";
+    Harness[Harness["GITHUB_COPILOT_CLI"] = 7] = "GITHUB_COPILOT_CLI";
+    Harness[Harness["FACTORY_DROID"] = 8] = "FACTORY_DROID";
+    Harness[Harness["HERMES"] = 9] = "HERMES";
+    Harness[Harness["JETBRAINS_JUNIE"] = 10] = "JETBRAINS_JUNIE";
+    Harness[Harness["KILO_CODE"] = 11] = "KILO_CODE";
+    Harness[Harness["KIRO"] = 12] = "KIRO";
+    Harness[Harness["PI"] = 13] = "PI";
+    Harness[Harness["TRAE"] = 14] = "TRAE";
+    Harness[Harness["VSCODE"] = 15] = "VSCODE";
+    Harness[Harness["GOOGLE_ANTIGRAVITY"] = 16] = "GOOGLE_ANTIGRAVITY";
+    Harness[Harness["KIMI_CODE"] = 17] = "KIMI_CODE";
+    Harness[Harness["MISTRAL_VIBE"] = 18] = "MISTRAL_VIBE";
+    Harness[Harness["XAI_GROK_BUILD"] = 19] = "XAI_GROK_BUILD";
+})(Harness || (exports.Harness = Harness = {}));
+var Scope;
+(function (Scope) {
+    Scope[Scope["USER"] = 1] = "USER";
+    Scope[Scope["PROJECT"] = 2] = "PROJECT";
+})(Scope || (exports.Scope = Scope = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.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,IAAY,OAoBX;AApBD,WAAY,OAAO;IACf,uEAAyB,CAAA;IACzB,qDAAgB,CAAA;IAChB,6CAAY,CAAA;IACZ,yCAAU,CAAA;IACV,mCAAO,CAAA;IACP,6CAAY,CAAA;IACZ,iEAAsB,CAAA;IACtB,uDAAiB,CAAA;IACjB,yCAAU,CAAA;IACV,4DAAoB,CAAA;IACpB,gDAAc,CAAA;IACd,sCAAS,CAAA;IACT,kCAAO,CAAA;IACP,sCAAS,CAAA;IACT,0CAAW,CAAA;IACX,kEAAuB,CAAA;IACvB,gDAAc,CAAA;IACd,sDAAiB,CAAA;IACjB,0DAAmB,CAAA;AACvB,CAAC,EApBW,OAAO,uBAAP,OAAO,QAoBlB;AAED,IAAY,KAGX;AAHD,WAAY,KAAK;IACb,iCAAQ,CAAA;IACR,uCAAW,CAAA;AACf,CAAC,EAHW,KAAK,qBAAL,KAAK,QAGhB"}