@ranimontagna/agent-toolkit 0.1.1

package/dist/src/state.js

@@ -0,0 +1,137 @@
+import path from "node:path";
+import { HOME, REPO_ROOT } from "./context.js";
+import { formatGithubPackageSpec, formatNpmPackageSpec, formatPythonPackageSpec, githubReleaseApiUrl, loadToolLock, } from "./tool-lock.js";
+export const toolNames = [
+    "rtk",
+    "caveman",
+    "superpowers",
+    "graphify",
+    "gsd",
+    "frontend-skills",
+    "skills",
+];
+export const runtimeNames = ["claude", "codex", "opencode", "gemini"];
+function envInstallScope(value) {
+    return value === "local" ? "local" : "global";
+}
+export function isToolName(value) {
+    return toolNames.includes(value);
+}
+export function isRuntimeName(value) {
+    return runtimeNames.includes(value);
+}
+export function splitList(value) {
+    return value
+        .split(",")
+        .map((item) => item.trim().toLowerCase())
+        .filter(Boolean);
+}
+export function normalizeScope(scope) {
+    return scope
+        .trim()
+        .toLowerCase()
+        .replace(/\\/g, "/")
+        .replace(/^\/+|\/+$/g, "");
+}
+const toolLock = loadToolLock();
+export const state = {
+    rtkInstallDir: process.env.RTK_INSTALL_DIR || path.join(HOME, ".local", "bin"),
+    rtkGithub: process.env.RTK_GITHUB ||
+        githubReleaseApiUrl(toolLock.tools.rtk.repository, toolLock.tools.rtk.tag),
+    rtkAssetChecksums: Object.fromEntries(Object.entries(toolLock.tools.rtk.assets).map(([assetName, asset]) => [
+        assetName,
+        asset.sha256,
+    ])),
+    cavemanPackage: process.env.CAVEMAN_PACKAGE ||
+        formatGithubPackageSpec(toolLock.tools.caveman.repository, toolLock.tools.caveman.ref),
+    cavemanMode: process.env.CAVEMAN_MODE || "minimal",
+    graphifyPackage: process.env.GRAPHIFY_PACKAGE ||
+        formatPythonPackageSpec(toolLock.tools.graphify.package, toolLock.tools.graphify.version),
+    graphifyInstaller: process.env.GRAPHIFY_INSTALLER || "uv",
+    gsdPackage: process.env.GSD_PACKAGE ||
+        formatNpmPackageSpec(toolLock.tools.gsd.package, toolLock.tools.gsd.version),
+    frontendSkillsCliPackage: process.env.SKILLS_CLI_PACKAGE ||
+        formatNpmPackageSpec(toolLock.tools.frontendSkills.skillsCli.package, toolLock.tools.frontendSkills.skillsCli.version),
+    frontendSkillSources: [
+        {
+            label: "Impeccable",
+            repository: toolLock.tools.frontendSkills.impeccable.repository,
+            ref: toolLock.tools.frontendSkills.impeccable.ref,
+            skill: toolLock.tools.frontendSkills.impeccable.skill,
+        },
+        {
+            label: "Taste Skill",
+            repository: toolLock.tools.frontendSkills.tasteSkill.repository,
+            ref: toolLock.tools.frontendSkills.tasteSkill.ref,
+            skill: toolLock.tools.frontendSkills.tasteSkill.skill,
+        },
+    ],
+    gsdScope: envInstallScope(process.env.GSD_SCOPE),
+    customSkillsDir: process.env.CUSTOM_SKILLS_DIR || path.join(REPO_ROOT, "skills"),
+    skillScopes: splitList(process.env.SKILLS_SCOPE || ""),
+    listSkills: false,
+    cliPackages: {
+        claude: process.env.CLAUDE_CLI_PACKAGE ||
+            formatNpmPackageSpec(toolLock.runtimeClis.claude.package, toolLock.runtimeClis.claude.version),
+        codex: process.env.CODEX_CLI_PACKAGE ||
+            formatNpmPackageSpec(toolLock.runtimeClis.codex.package, toolLock.runtimeClis.codex.version),
+        opencode: process.env.OPENCODE_CLI_PACKAGE ||
+            formatNpmPackageSpec(toolLock.runtimeClis.opencode.package, toolLock.runtimeClis.opencode.version),
+        gemini: process.env.GEMINI_CLI_PACKAGE ||
+            formatNpmPackageSpec(toolLock.runtimeClis.gemini.package, toolLock.runtimeClis.gemini.version),
+    },
+    tools: {
+        rtk: true,
+        caveman: true,
+        superpowers: true,
+        graphify: true,
+        gsd: true,
+        "frontend-skills": true,
+        skills: true,
+    },
+    runtimes: {
+        claude: true,
+        codex: true,
+        opencode: true,
+        gemini: true,
+    },
+    nonInteractive: false,
+    installMissingClis: false,
+    allowMutableSources: process.env.ALLOW_MUTABLE_SOURCES === "1",
+};
+export const runtimeMeta = {
+    claude: {
+        command: "claude",
+        label: "Claude Code CLI",
+        display: "Claude Code",
+    },
+    codex: { command: "codex", label: "Codex CLI", display: "Codex CLI" },
+    opencode: { command: "opencode", label: "OpenCode CLI", display: "OpenCode" },
+    gemini: { command: "gemini", label: "Gemini CLI", display: "Gemini CLI" },
+};
+export function setAllTools(value) {
+    for (const key of toolNames)
+        state.tools[key] = value;
+}
+export function selectOnlyTool(tool) {
+    setAllTools(false);
+    state.tools[tool] = true;
+}
+export function setAllRuntimes(value) {
+    for (const key of runtimeNames)
+        state.runtimes[key] = value;
+}
+export function selectOnlyRuntime(runtime) {
+    setAllRuntimes(false);
+    state.runtimes[runtime] = true;
+}
+export function anyToolSelected() {
+    return Object.values(state.tools).some(Boolean);
+}
+export function anyRuntimeSelected() {
+    return Object.values(state.runtimes).some(Boolean);
+}
+export function normalizedSkillScopes() {
+    return state.skillScopes.map(normalizeScope).filter(Boolean);
+}
+//# sourceMappingURL=state.js.map

package/dist/src/state.js.map

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

package/dist/src/system.d.ts

@@ -0,0 +1,21 @@
+type RunOptions = {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    capture?: boolean;
+};
+export type RunResult = {
+    ok: boolean;
+    status: number;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+};
+export declare function findCommand(command: string): string | null;
+export declare function commandExists(command: string): boolean;
+export declare function run(command: string, args?: string[], options?: RunOptions): RunResult;
+export declare function capture(command: string, args?: string[]): RunResult;
+export declare function requireCommand(command: string): void;
+export declare function requireNode(requiredMajor: number): void;
+export declare function fetchJson(url: string): Promise<unknown>;
+export declare function downloadFile(url: string, destination: string): Promise<void>;
+export {};

package/dist/src/system.js

@@ -0,0 +1,109 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import http from "node:http";
+import https from "node:https";
+import path from "node:path";
+import process from "node:process";
+import { die } from "./logger.js";
+export function findCommand(command) {
+    const pathValue = process.env.PATH || "";
+    const pathExt = process.platform === "win32"
+        ? (process.env.PATHEXT || ".EXE;.CMD;.BAT;.COM").split(";")
+        : [""];
+    for (const dir of pathValue.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of pathExt) {
+            const candidate = path.join(dir, `${command}${ext}`);
+            try {
+                fs.accessSync(candidate, fs.constants.X_OK);
+                return candidate;
+            }
+            catch {
+                // Continue scanning PATH.
+            }
+        }
+    }
+    return null;
+}
+export function commandExists(command) {
+    return Boolean(findCommand(command));
+}
+export function run(command, args = [], options = {}) {
+    const result = spawnSync(command, args, {
+        cwd: options.cwd || process.cwd(),
+        env: options.env || process.env,
+        encoding: "utf8",
+        stdio: options.capture ? ["ignore", "pipe", "pipe"] : "inherit",
+    });
+    if (result.error) {
+        return {
+            ok: false,
+            status: typeof result.status === "number" ? result.status : 1,
+            stdout: result.stdout || "",
+            stderr: result.stderr || result.error.message,
+            error: result.error,
+        };
+    }
+    return {
+        ok: result.status === 0,
+        status: result.status ?? 0,
+        stdout: result.stdout || "",
+        stderr: result.stderr || "",
+    };
+}
+export function capture(command, args = []) {
+    return run(command, args, { capture: true });
+}
+export function requireCommand(command) {
+    if (!commandExists(command))
+        die(`Missing prerequisite: ${command}`);
+}
+export function requireNode(requiredMajor) {
+    const major = Number.parseInt(process.versions.node.split(".")[0] ?? "", 10);
+    if (!Number.isInteger(major) || major < requiredMajor) {
+        die(`Node.js >= ${requiredMajor} is required. Current: ${process.version}`);
+    }
+}
+function requestBuffer(url, redirects = 0) {
+    return new Promise((resolve, reject) => {
+        if (redirects > 5) {
+            reject(new Error("Too many redirects"));
+            return;
+        }
+        const client = url.startsWith("https:") ? https : http;
+        const request = client.get(url, {
+            headers: {
+                "User-Agent": "agent-toolkit",
+                Accept: "application/vnd.github+json, application/json",
+            },
+        }, (response) => {
+            const { statusCode = 0, headers } = response;
+            if ([301, 302, 303, 307, 308].includes(statusCode) &&
+                headers.location) {
+                response.resume();
+                const nextUrl = new URL(headers.location, url).toString();
+                requestBuffer(nextUrl, redirects + 1).then(resolve, reject);
+                return;
+            }
+            if (statusCode < 200 || statusCode >= 300) {
+                response.resume();
+                reject(new Error(`HTTP ${statusCode}`));
+                return;
+            }
+            const chunks = [];
+            response.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+            response.on("end", () => resolve(Buffer.concat(chunks)));
+        });
+        request.on("error", reject);
+    });
+}
+export async function fetchJson(url) {
+    const buffer = await requestBuffer(url);
+    return JSON.parse(buffer.toString("utf8"));
+}
+export async function downloadFile(url, destination) {
+    const buffer = await requestBuffer(url);
+    fs.writeFileSync(destination, buffer);
+}
+//# sourceMappingURL=system.js.map

package/dist/src/system.js.map

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

package/dist/src/tool-lock.d.ts

@@ -0,0 +1,60 @@
+export type RuntimeCliLockName = "claude" | "codex" | "opencode" | "gemini";
+export type ToolLock = {
+    version: 1;
+    tools: {
+        rtk: {
+            source: "github-release";
+            repository: string;
+            tag: string;
+            assets: Record<string, {
+                sha256: string;
+            }>;
+        };
+        caveman: {
+            source: "github";
+            repository: string;
+            ref: string;
+        };
+        graphify: {
+            source: "pypi";
+            package: string;
+            version: string;
+        };
+        gsd: {
+            source: "npm";
+            package: string;
+            version: string;
+        };
+        frontendSkills: {
+            source: "skills-cli";
+            skillsCli: {
+                source: "npm";
+                package: string;
+                version: string;
+            };
+            impeccable: {
+                source: "github";
+                repository: string;
+                ref: string;
+                skill: string;
+            };
+            tasteSkill: {
+                source: "github";
+                repository: string;
+                ref: string;
+                skill: string;
+            };
+        };
+    };
+    runtimeClis: Record<RuntimeCliLockName, {
+        source: "npm";
+        package: string;
+        version: string;
+    }>;
+};
+export declare function formatNpmPackageSpec(packageName: string, version: string): string;
+export declare function formatPythonPackageSpec(packageName: string, version: string): string;
+export declare function formatGithubPackageSpec(repository: string, ref: string): string;
+export declare function githubReleaseApiUrl(repository: string, tag: string): string;
+export declare function isMutableExternalSource(spec: string): boolean;
+export declare function loadToolLock(lockPath?: string): ToolLock;

package/dist/src/tool-lock.js

@@ -0,0 +1,109 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REPO_ROOT } from "./context.js";
+const exactVersionPattern = /^[0-9]+(?:\.[0-9]+){1,3}(?:[-+][0-9A-Za-z.-]+)?$/;
+const sha256Pattern = /^[a-f0-9]{64}$/i;
+const fullGitShaPattern = /^[a-f0-9]{40}$/i;
+export function formatNpmPackageSpec(packageName, version) {
+    return `${packageName}@${version}`;
+}
+export function formatPythonPackageSpec(packageName, version) {
+    return `${packageName}==${version}`;
+}
+export function formatGithubPackageSpec(repository, ref) {
+    return `github:${repository}#${ref}`;
+}
+export function githubReleaseApiUrl(repository, tag) {
+    return `https://api.github.com/repos/${repository}/releases/tags/${encodeURIComponent(tag)}`;
+}
+function npmVersionFromSpec(spec) {
+    if (spec.startsWith("@")) {
+        const slashIndex = spec.indexOf("/");
+        if (slashIndex === -1)
+            return null;
+        const versionIndex = spec.indexOf("@", slashIndex);
+        return versionIndex === -1 ? null : spec.slice(versionIndex + 1);
+    }
+    const versionIndex = spec.lastIndexOf("@");
+    return versionIndex <= 0 ? null : spec.slice(versionIndex + 1);
+}
+function isMutableVersion(version) {
+    if (!version)
+        return true;
+    if (["latest", "next", "canary", "beta", "alpha"].includes(version)) {
+        return true;
+    }
+    return !exactVersionPattern.test(version);
+}
+export function isMutableExternalSource(spec) {
+    if (spec.startsWith("github:")) {
+        const refIndex = spec.lastIndexOf("#");
+        if (refIndex === -1)
+            return true;
+        return !fullGitShaPattern.test(spec.slice(refIndex + 1));
+    }
+    if (spec.includes("==")) {
+        return isMutableVersion(spec.split("==").at(-1) ?? null);
+    }
+    return isMutableVersion(npmVersionFromSpec(spec));
+}
+function assertString(value, label) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new Error(`Invalid tools.lock.json: ${label} must be a string.`);
+    }
+}
+function assertExactVersion(value, label) {
+    assertString(value, label);
+    if (isMutableVersion(value)) {
+        throw new Error(`Invalid tools.lock.json: ${label} must be an exact version.`);
+    }
+}
+function assertGitSha(value, label) {
+    assertString(value, label);
+    if (!fullGitShaPattern.test(value)) {
+        throw new Error(`Invalid tools.lock.json: ${label} must be a full commit SHA.`);
+    }
+}
+function assertSha256(value, label) {
+    assertString(value, label);
+    if (!sha256Pattern.test(value)) {
+        throw new Error(`Invalid tools.lock.json: ${label} must be a SHA-256 hash.`);
+    }
+}
+function validateToolLock(lock) {
+    if (lock.version !== 1) {
+        throw new Error("Invalid tools.lock.json: version must be 1.");
+    }
+    assertString(lock.tools.rtk.repository, "tools.rtk.repository");
+    assertString(lock.tools.rtk.tag, "tools.rtk.tag");
+    if (lock.tools.rtk.tag === "latest") {
+        throw new Error("Invalid tools.lock.json: tools.rtk.tag must not be latest.");
+    }
+    for (const [assetName, asset] of Object.entries(lock.tools.rtk.assets)) {
+        assertSha256(asset.sha256, `tools.rtk.assets.${assetName}.sha256`);
+    }
+    assertString(lock.tools.caveman.repository, "tools.caveman.repository");
+    assertGitSha(lock.tools.caveman.ref, "tools.caveman.ref");
+    assertString(lock.tools.graphify.package, "tools.graphify.package");
+    assertExactVersion(lock.tools.graphify.version, "tools.graphify.version");
+    assertString(lock.tools.gsd.package, "tools.gsd.package");
+    assertExactVersion(lock.tools.gsd.version, "tools.gsd.version");
+    assertString(lock.tools.frontendSkills.skillsCli.package, "tools.frontendSkills.skillsCli.package");
+    assertExactVersion(lock.tools.frontendSkills.skillsCli.version, "tools.frontendSkills.skillsCli.version");
+    for (const skillName of ["impeccable", "tasteSkill"]) {
+        assertString(lock.tools.frontendSkills[skillName].repository, `tools.frontendSkills.${skillName}.repository`);
+        assertGitSha(lock.tools.frontendSkills[skillName].ref, `tools.frontendSkills.${skillName}.ref`);
+        assertString(lock.tools.frontendSkills[skillName].skill, `tools.frontendSkills.${skillName}.skill`);
+    }
+    for (const runtime of ["claude", "codex", "opencode", "gemini"]) {
+        assertString(lock.runtimeClis[runtime].package, `runtimeClis.${runtime}.package`);
+        assertExactVersion(lock.runtimeClis[runtime].version, `runtimeClis.${runtime}.version`);
+    }
+    return lock;
+}
+export function loadToolLock(lockPath = process.env.TOOLS_LOCK_PATH ||
+    path.join(REPO_ROOT, "tools.lock.json")) {
+    const raw = fs.readFileSync(lockPath, "utf8");
+    return validateToolLock(JSON.parse(raw));
+}
+//# sourceMappingURL=tool-lock.js.map

package/dist/src/tool-lock.js.map

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

package/dist/src/ui.d.ts

@@ -0,0 +1,3 @@
+export declare function printHeader(): void;
+export declare function printSelections(): void;
+export declare function printSummary(): void;

package/dist/src/ui.js

@@ -0,0 +1,41 @@
+import { color, step } from "./logger.js";
+import { normalizedSkillScopes, runtimeMeta, runtimeNames, state, } from "./state.js";
+export function printHeader() {
+    console.log("");
+    console.log(`${color.bold}Agent Toolkit${color.reset}`);
+    console.log("Personal toolkit installer for AI coding agents");
+    console.log("");
+}
+export function printSelections() {
+    console.log(`  ${color.bold}Selected tools:${color.reset}`);
+    if (state.tools.rtk)
+        console.log(`   ${color.green}+${color.reset} RTK`);
+    if (state.tools.caveman)
+        console.log(`   ${color.green}+${color.reset} Caveman`);
+    if (state.tools.superpowers)
+        console.log(`   ${color.green}+${color.reset} Superpowers`);
+    if (state.tools.graphify)
+        console.log(`   ${color.green}+${color.reset} Graphify`);
+    if (state.tools.gsd)
+        console.log(`   ${color.green}+${color.reset} GSD`);
+    if (state.tools.skills)
+        console.log(`   ${color.green}+${color.reset} Custom Skills`);
+    console.log("");
+    console.log(`  ${color.bold}Target runtimes:${color.reset}`);
+    for (const runtime of runtimeNames) {
+        if (state.runtimes[runtime])
+            console.log(`   ${color.green}+${color.reset} ${runtimeMeta[runtime].display}`);
+    }
+    console.log("");
+}
+export function printSummary() {
+    step("Summary");
+    console.log(`   Scope: ${state.gsdScope}`);
+    console.log(`   Skills source: ${state.customSkillsDir}`);
+    const scopes = normalizedSkillScopes();
+    if (scopes.length > 0)
+        console.log(`   Skills scope: ${scopes.join(", ")}`);
+    console.log("");
+    console.log("   Restart open agent sessions after installing plugins or skills.");
+}
+//# sourceMappingURL=ui.js.map

package/dist/src/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,kBAAkB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO;QACrB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,UAAU,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW;QACzB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,cAAc,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ;QACtB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,WAAW,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM;QACpB,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,gBAAgB,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,mBAAmB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YACzB,OAAO,CAAC,GAAG,CACT,MAAM,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CACnE,CAAC;IACN,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,SAAS,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,oEAAoE,CACrE,CAAC;AACJ,CAAC"}

package/dist/src/usage.d.ts

@@ -0,0 +1 @@
+export declare function usage(): string;

package/dist/src/usage.js

@@ -0,0 +1,66 @@
+export function usage() {
+    return `Agent Toolkit installer
+
+Usage:
+  bash setup-agent-toolkit.sh [options]
+  npx -y @ranimontagna/agent-toolkit [options]
+
+Tools:
+  --all                 Install every tool without the menu
+  --rtk-only            Install only RTK
+  --caveman-only        Install only Caveman
+  --superpowers-only    Install only Superpowers
+  --graphify-only       Install only Graphify
+  --gsd-only            Install only GSD
+  --frontend-skills-only Install only third-party frontend skills
+  --skills-only         Install only Custom Skills
+  --no-rtk              Skip RTK
+  --no-caveman          Skip Caveman
+  --no-superpowers      Skip Superpowers
+  --no-graphify         Skip Graphify
+  --no-gsd              Skip GSD
+  --no-frontend-skills  Skip third-party frontend skills
+  --no-skills           Skip Custom Skills
+
+Runtimes:
+  --all-runtimes        Target Claude Code, Codex CLI, OpenCode and Gemini CLI
+  --claude              Target only Claude Code
+  --codex               Target only Codex CLI
+  --opencode            Target only OpenCode
+  --gemini              Target only Gemini CLI
+  --no-claude           Skip Claude Code
+  --no-codex            Skip Codex CLI
+  --no-opencode         Skip OpenCode
+  --no-gemini           Skip Gemini CLI
+
+Install scope:
+  --global              Install runtime assets into user config directories
+  --local               Install runtime assets into the current project
+  --skills-dir DIR      Use another source directory for Custom Skills
+  --skills-scope SCOPE  Install skills under a relative scope path, repeatable
+  --skills-list         List discovered Custom Skills and exit
+
+Other:
+  --install-missing-clis Install selected runtime CLIs if missing
+  --allow-mutable-sources Allow explicit mutable package sources like @latest
+  --help, -h            Show this help
+
+Environment:
+  RTK_INSTALL_DIR       RTK binary install directory
+  CAVEMAN_PACKAGE       Caveman package source
+  CAVEMAN_MODE          minimal or all
+  GRAPHIFY_PACKAGE      Python package used to install Graphify
+  GRAPHIFY_INSTALLER    uv or pipx
+  GSD_PACKAGE           GSD package source
+  SKILLS_CLI_PACKAGE    npm package used for third-party skill installs
+  GSD_SCOPE             global or local
+  TOOLS_LOCK_PATH       External tool provenance lock path
+  ALLOW_MUTABLE_SOURCES Set to 1 to allow mutable source overrides
+  CUSTOM_SKILLS_DIR     Source directory for custom skills
+  SKILLS_SCOPE          Comma-separated skill scope filters
+  CLAUDE_CLI_PACKAGE    npm package used to install Claude Code CLI
+  CODEX_CLI_PACKAGE     npm package used to install Codex CLI
+  OPENCODE_CLI_PACKAGE  npm package used to install OpenCode CLI
+  GEMINI_CLI_PACKAGE    npm package used to install Gemini CLI`;
+}
+//# sourceMappingURL=usage.js.map

package/dist/src/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK;IACnB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+DA8DsD,CAAC;AAChE,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ranimontagna/agent-toolkit",
+  "version": "0.1.1",
+  "description": "Personal AI agent toolkit installer for Claude Code, Codex CLI, OpenCode, Gemini CLI and graph-aware workflows.",
+  "type": "module",
+  "bin": {
+    "agent-toolkit": "dist/bin/agent-toolkit.js",
+    "setup-agent-toolkit": "dist/bin/agent-toolkit.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "tools.lock.json",
+    "setup-agent-toolkit.sh",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "npm run lint && npm run typecheck && npm run test:unit && npm run build && find dist/bin dist/src -name '*.js' -print0 | xargs -0 -n1 node --check && bash -n setup-agent-toolkit.sh && npm run test:integration",
+    "format": "biome format --write .",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "prepare": "npm run build",
+    "security": "npm run security:audit && npm run security:signatures",
+    "security:audit": "npm audit --audit-level=moderate",
+    "security:signatures": "npm audit signatures",
+    "test": "npm run test:unit && npm run test:integration",
+    "test:integration": "npm run build && bash tests/test-agent-toolkit.sh",
+    "test:unit": "vitest run",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raniellimontagna/agent-toolkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/raniellimontagna/agent-toolkit/issues"
+  },
+  "homepage": "https://github.com/raniellimontagna/agent-toolkit#readme",
+  "license": "MIT",
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}