mthds 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Evotis S.A.S.
+
+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,60 @@
+# mthds
+
+CLI for installing and managing **methods** — reusable workflows for AI coding agents.
+
+## What is a method?
+
+A method is a packaged workflow that an AI agent (like Claude Code) can use. Methods are stored in a registry and installed locally via their unique slug.
+
+## Install a method
+
+```bash
+npx mthds install <slug>
+```
+
+The CLI will:
+
+1. Look up the method in the registry
+2. Ask which AI agent to install it for (Claude Code, with more coming soon)
+3. Ask where to install — **local** (current project) or **global** (your machine)
+4. Optionally install the pipelex software runtime
+5. Write the method to `.claude/methods/<slug>/METHOD.mthds`
+
+### Install locations
+
+| Location | Path |
+|----------|------|
+| Local | `<cwd>/.claude/methods/<slug>/` |
+| Global | `~/.claude/methods/<slug>/` |
+
+## Install software runtime
+
+```bash
+npx mthds setup software pipelex
+```
+
+Installs [uv](https://docs.astral.sh/uv/) and [pipelex](https://pipelex.dev) so methods that depend on them can run.
+
+## Telemetry
+
+Anonymous usage data (method slug + timestamp) is collected to help rank methods on the leaderboard. No personal or device information is collected.
+
+To opt out:
+
+```bash
+DISABLE_TELEMETRY=1 npx mthds install <slug>
+```
+
+## Development
+
+```bash
+make install    # install dependencies
+make check      # typecheck + build
+make dev        # watch mode
+make run        # build and run the CLI
+make pack       # create tarball for local npx testing
+```
+
+## License
+
+MIT

package/dist/agents/claude-code.d.ts

@@ -0,0 +1,2 @@
+import type { AgentHandler } from "./types.js";
+export declare const claudeCodeHandler: AgentHandler;

package/dist/agents/claude-code.js

@@ -0,0 +1,21 @@
+import { join } from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+import * as p from "@clack/prompts";
+import { Agent } from "./types.js";
+export const claudeCodeHandler = {
+    id: Agent.ClaudeCode,
+    label: "Claude Code",
+    supported: true,
+    async installMethod(ctx) {
+        const s = p.spinner();
+        s.start(`Installing method "${ctx.method}" for Claude Code...`);
+        // TODO: When multi-agent support ships, offer symlink vs copy strategy.
+        // Symlink: store method once in a canonical location, symlink from each agent's dir.
+        // Copy: independent copies per agent. Fallback when symlinks aren't supported.
+        const methodDir = join(ctx.targetDir, ctx.method);
+        mkdirSync(methodDir, { recursive: true });
+        writeFileSync(join(methodDir, "METHOD.mthds"), ctx.content, "utf-8");
+        s.stop(`Method "${ctx.method}" installed to ${methodDir}`);
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/agents/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/agents/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,EAAE,EAAE,KAAK,CAAC,UAAU;IACpB,KAAK,EAAE,aAAa;IACpB,SAAS,EAAE,IAAI;IAEf,KAAK,CAAC,aAAa,CAAC,GAAmB;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC,CAAC,KAAK,CAAC,sBAAsB,GAAG,CAAC,MAAM,sBAAsB,CAAC,CAAC;QAEhE,wEAAwE;QACxE,qFAAqF;QACrF,+EAA+E;QAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,aAAa,CACX,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EAC/B,GAAG,CAAC,OAAO,EACX,OAAO,CACR,CAAC;QAEF,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,MAAM,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;CACF,CAAC"}

package/dist/agents/cursor.d.ts

@@ -0,0 +1,2 @@
+import type { AgentHandler } from "./types.js";
+export declare const cursorHandler: AgentHandler;

package/dist/agents/cursor.js

@@ -0,0 +1,11 @@
+import { Agent } from "./types.js";
+export const cursorHandler = {
+    id: Agent.Cursor,
+    label: "Cursor",
+    supported: false,
+    hint: "coming soon",
+    async installMethod(_ctx) {
+        throw new Error("Cursor is not supported yet.");
+    },
+};
+//# sourceMappingURL=cursor.js.map

package/dist/agents/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/agents/cursor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAiB;IACzC,EAAE,EAAE,KAAK,CAAC,MAAM;IAChB,KAAK,EAAE,QAAQ;IACf,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,aAAa;IAEnB,KAAK,CAAC,aAAa,CAAC,IAAoB;QACtC,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/agents/github-copilot.d.ts

@@ -0,0 +1,2 @@
+import type { AgentHandler } from "./types.js";
+export declare const githubCopilotHandler: AgentHandler;

package/dist/agents/github-copilot.js

@@ -0,0 +1,11 @@
+import { Agent } from "./types.js";
+export const githubCopilotHandler = {
+    id: Agent.GithubCopilot,
+    label: "GitHub Copilot",
+    supported: false,
+    hint: "coming soon",
+    async installMethod(_ctx) {
+        throw new Error("GitHub Copilot is not supported yet.");
+    },
+};
+//# sourceMappingURL=github-copilot.js.map

package/dist/agents/github-copilot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-copilot.js","sourceRoot":"","sources":["../../src/agents/github-copilot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD,EAAE,EAAE,KAAK,CAAC,aAAa;IACvB,KAAK,EAAE,gBAAgB;IACvB,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,aAAa;IAEnB,KAAK,CAAC,aAAa,CAAC,IAAoB;QACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC"}

package/dist/agents/registry.d.ts

@@ -0,0 +1,4 @@
+import type { Agent, AgentHandler } from "./types.js";
+export declare function getAgentHandler(agent: Agent): AgentHandler;
+export declare function getAllAgents(): readonly AgentHandler[];
+export declare function getSupportedAgents(): readonly AgentHandler[];

package/dist/agents/registry.js

@@ -0,0 +1,24 @@
+import { claudeCodeHandler } from "./claude-code.js";
+import { cursorHandler } from "./cursor.js";
+import { windsurfHandler } from "./windsurf.js";
+import { githubCopilotHandler } from "./github-copilot.js";
+const handlers = new Map([
+    [claudeCodeHandler.id, claudeCodeHandler],
+    [cursorHandler.id, cursorHandler],
+    [windsurfHandler.id, windsurfHandler],
+    [githubCopilotHandler.id, githubCopilotHandler],
+]);
+export function getAgentHandler(agent) {
+    const handler = handlers.get(agent);
+    if (!handler) {
+        throw new Error(`No handler registered for agent: ${agent}`);
+    }
+    return handler;
+}
+export function getAllAgents() {
+    return [...handlers.values()];
+}
+export function getSupportedAgents() {
+    return getAllAgents().filter((h) => h.supported);
+}
+//# sourceMappingURL=registry.js.map

package/dist/agents/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/agents/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,QAAQ,GAAqC,IAAI,GAAG,CAAC;IACzD,CAAC,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,CAAC;IACzC,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC;IACjC,CAAC,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC;IACrC,CAAC,oBAAoB,CAAC,EAAE,EAAE,oBAAoB,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACnD,CAAC"}

package/dist/agents/types.d.ts

@@ -0,0 +1,26 @@
+export declare const Agent: {
+    readonly ClaudeCode: "claude-code";
+    readonly Cursor: "cursor";
+    readonly Windsurf: "windsurf";
+    readonly GithubCopilot: "github-copilot";
+};
+export type Agent = (typeof Agent)[keyof typeof Agent];
+export declare const InstallLocation: {
+    readonly Local: "local";
+    readonly Global: "global";
+};
+export type InstallLocation = (typeof InstallLocation)[keyof typeof InstallLocation];
+export interface InstallContext {
+    readonly method: string;
+    readonly content: string;
+    readonly agent: Agent;
+    readonly location: InstallLocation;
+    readonly targetDir: string;
+}
+export interface AgentHandler {
+    readonly id: Agent;
+    readonly label: string;
+    readonly supported: boolean;
+    readonly hint?: string;
+    installMethod(ctx: InstallContext): Promise<void>;
+}

package/dist/agents/types.js

@@ -0,0 +1,11 @@
+export const Agent = {
+    ClaudeCode: "claude-code",
+    Cursor: "cursor",
+    Windsurf: "windsurf",
+    GithubCopilot: "github-copilot",
+};
+export const InstallLocation = {
+    Local: "local",
+    Global: "global",
+};
+//# sourceMappingURL=types.js.map

package/dist/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agents/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,UAAU,EAAE,aAAa;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAIX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/dist/agents/windsurf.d.ts

@@ -0,0 +1,2 @@
+import type { AgentHandler } from "./types.js";
+export declare const windsurfHandler: AgentHandler;

package/dist/agents/windsurf.js

@@ -0,0 +1,11 @@
+import { Agent } from "./types.js";
+export const windsurfHandler = {
+    id: Agent.Windsurf,
+    label: "Windsurf",
+    supported: false,
+    hint: "coming soon",
+    async installMethod(_ctx) {
+        throw new Error("Windsurf is not supported yet.");
+    },
+};
+//# sourceMappingURL=windsurf.js.map

package/dist/agents/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/agents/windsurf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,eAAe,GAAiB;IAC3C,EAAE,EAAE,KAAK,CAAC,QAAQ;IAClB,KAAK,EAAE,UAAU;IACjB,SAAS,EAAE,KAAK;IAChB,IAAI,EAAE,aAAa;IAEnB,KAAK,CAAC,aAAa,CAAC,IAAoB;QACtC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CACF,CAAC"}

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { Command, CommanderError } from "commander";
+import { createRequire } from "node:module";
+import * as p from "@clack/prompts";
+import { showBanner } from "./commands/index.js";
+import { printLogo } from "./commands/index.js";
+import { installSoftware } from "./commands/setup.js";
+import { installMethod } from "./commands/install.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+const program = new Command();
+program
+    .name("mthds")
+    .version(pkg.version)
+    .description("CLI bridge to the Pipelex runtime")
+    .exitOverride()
+    .configureOutput({
+    writeOut: () => { },
+    writeErr: () => { },
+});
+// mthds install <slug>
+program
+    .command("install")
+    .argument("<slug>", "Method slug to install")
+    .description("Install a method")
+    .exitOverride()
+    .action(async (slug) => {
+    await installMethod(slug);
+});
+// mthds setup software <name>
+const setup = program.command("setup").exitOverride();
+setup
+    .command("software <name>")
+    .description("Install a software runtime (e.g. pipelex)")
+    .exitOverride()
+    .action(async (name) => {
+    await installSoftware(name);
+});
+// Default: show banner
+program.action(() => {
+    showBanner();
+});
+program.parseAsync(process.argv).catch((err) => {
+    if (err instanceof CommanderError) {
+        // --help and --version exit with code 0
+        if (err.exitCode === 0) {
+            process.exit(0);
+        }
+        printLogo();
+        p.intro("mthds");
+        const message = err.message
+            .replace(/^error: /, "")
+            .replace(/^Error: /, "");
+        p.log.error(message);
+        if (err.code === "commander.missingArgument") {
+            p.log.info("Run mthds --help to see usage.");
+        }
+        p.outro("");
+        process.exit(1);
+    }
+    printLogo();
+    p.intro("mthds");
+    p.log.error(err.message);
+    p.outro("");
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,2 @@
+export declare function printLogo(): void;
+export declare function showBanner(): void;

package/dist/commands/index.js

@@ -0,0 +1,45 @@
+import chalk from "chalk";
+import { createRequire } from "node:module";
+function getVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        const pkg = require("../../package.json");
+        return pkg.version;
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const LOGO = [
+    "                    __  __              __",
+    "   ____ ___  ___  / /_/ /_  ____  ____/ /____",
+    "  / __ `__ \\/ _ \\/ __/ __ \\/ __ \\/ __  / ___/",
+    " / / / / / /  __/ /_/ / / / /_/ / /_/ (__  )",
+    "/_/ /_/ /_/\\___/\\__/_/ /_/\\____/\\__,_/____/",
+];
+export function printLogo() {
+    console.log();
+    for (const line of LOGO) {
+        console.log(chalk.white(line));
+    }
+    console.log();
+}
+export function showBanner() {
+    const version = getVersion();
+    printLogo();
+    console.log(chalk.dim(`  v${version}\n`));
+    console.log(chalk.bold("  Usage:"));
+    console.log(`    ${chalk.green("mthds")} ${chalk.yellow("<command>")} [options]\n`);
+    console.log(chalk.bold("  Commands:"));
+    console.log(`    ${chalk.yellow("install <slug>")}         Install a method`);
+    console.log(`    ${chalk.yellow("setup software <name>")} Install a software runtime`);
+    console.log(`    ${chalk.yellow("--help")}                  Show this help message`);
+    console.log(`    ${chalk.yellow("--version")}               Show version\n`);
+    console.log(chalk.bold("  Examples:"));
+    console.log(`    ${chalk.dim("$")} mthds install my-method-slug`);
+    console.log(`    ${chalk.dim("$")} mthds setup software pipelex\n`);
+    console.log(chalk.dim("  Docs: https://pipelex.dev/docs\n"));
+    console.log(chalk.bold("  Telemetry:"));
+    console.log(chalk.dim("  Anonymous usage data (method slug + timestamp) is collected\n  to help rank methods. No personal info is collected.\n  Opt out: DISABLE_TELEMETRY=1\n"));
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;QACjE,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,IAAI,GAAG;IACX,4CAA4C;IAC5C,+CAA+C;IAC/C,mDAAmD;IACnD,8CAA8C;IAC9C,iDAAiD;CAClD,CAAC;AAEF,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAEpF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CACT,OAAO,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,2BAA2B,CACjE,CAAC;IACF,OAAO,CAAC,GAAG,CACT,OAAO,KAAK,CAAC,MAAM,CAAC,uBAAuB,CAAC,6BAA6B,CAC1E,CAAC;IACF,OAAO,CAAC,GAAG,CACT,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,0CAA0C,CACxE,CAAC;IACF,OAAO,CAAC,GAAG,CACT,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,+BAA+B,CAChE,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAEpE,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAChD,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,yJAAyJ,CAC1J,CACF,CAAC;AACJ,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function installMethod(slug: string): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,104 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { mkdirSync } from "node:fs";
+import * as p from "@clack/prompts";
+import { isPipelexInstalled } from "../runtime/check.js";
+import { ensureRuntime } from "../runtime/installer.js";
+import { trackMethodInstall, shutdown } from "../telemetry/posthog.js";
+import { printLogo } from "./index.js";
+import { InstallLocation as Loc } from "../agents/types.js";
+import { getAllAgents, getAgentHandler } from "../agents/registry.js";
+import { fetchMethodBySlug } from "../supabase/methods.js";
+export async function installMethod(slug) {
+    printLogo();
+    p.intro("mthds install");
+    // Step 0: Check if the method exists
+    const s = p.spinner();
+    s.start(`Looking up method "${slug}"...`);
+    const method = await fetchMethodBySlug(slug);
+    if (!method) {
+        s.stop(`Method "${slug}" not found.`);
+        p.log.error(`No method with slug "${slug}" exists.`);
+        p.log.info("Check the slug and try again.");
+        p.outro("");
+        process.exit(1);
+    }
+    if (!method.content) {
+        s.stop(`Method "${slug}" has no content.`);
+        p.log.error("This method is missing its content and cannot be installed.");
+        p.outro("");
+        process.exit(1);
+    }
+    s.stop(`Found "${method.name}"${method.description ? ` — ${method.description}` : ""}`);
+    // Step 1: Which AI agent?
+    const agents = getAllAgents();
+    const agentOptions = agents.map((a) => ({
+        value: a.id,
+        label: a.label,
+        hint: a.supported ? undefined : (a.hint ?? "not supported"),
+        disabled: !a.supported,
+    }));
+    const selectedAgent = await p.select({
+        message: "Which AI agent do you want to install this method for?",
+        options: agentOptions,
+    });
+    if (p.isCancel(selectedAgent)) {
+        p.cancel("Installation cancelled.");
+        process.exit(0);
+    }
+    // Step 2: Local or global?
+    const localDir = join(process.cwd(), ".claude", "methods");
+    const globalDir = join(homedir(), ".claude", "methods");
+    const selectedLocation = await p.select({
+        message: "Where do you want to install this method?",
+        options: [
+            {
+                value: Loc.Local,
+                label: "Local",
+                hint: localDir,
+            },
+            {
+                value: Loc.Global,
+                label: "Global",
+                hint: globalDir,
+            },
+        ],
+    });
+    if (p.isCancel(selectedLocation)) {
+        p.cancel("Installation cancelled.");
+        process.exit(0);
+    }
+    // Step 3: Optional software install
+    const wantsSoftware = await p.confirm({
+        message: "Do you want to install software now? (optional)",
+        initialValue: false,
+    });
+    if (p.isCancel(wantsSoftware)) {
+        p.cancel("Installation cancelled.");
+        process.exit(0);
+    }
+    if (wantsSoftware) {
+        if (!isPipelexInstalled()) {
+            await ensureRuntime();
+            p.log.success("pipelex installed.");
+        }
+        else {
+            p.log.success("pipelex is already installed.");
+        }
+    }
+    // Step 4: Install via the agent handler
+    const targetDir = selectedLocation === Loc.Global ? globalDir : localDir;
+    mkdirSync(targetDir, { recursive: true });
+    const handler = getAgentHandler(selectedAgent);
+    trackMethodInstall(slug);
+    await handler.installMethod({
+        method: slug,
+        content: method.content,
+        agent: selectedAgent,
+        location: selectedLocation,
+        targetDir,
+    });
+    p.outro("Done");
+    await shutdown();
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1 @@
+export declare function runCommand(args: string[]): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,9 @@
+import { spawnPipelex } from "../runtime/spawn.js";
+import { trackEvent, shutdown } from "../telemetry/posthog.js";
+export async function runCommand(args) {
+    trackEvent("command_run", { command: args[0] ?? "unknown" });
+    const exitCode = await spawnPipelex(args);
+    await shutdown();
+    process.exit(exitCode);
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAc;IAC7C,UAAU,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IAE7D,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,QAAQ,EAAE,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare function installSoftware(name: string): Promise<void>;

package/dist/commands/setup.js

@@ -0,0 +1,26 @@
+import * as p from "@clack/prompts";
+import { isPipelexInstalled } from "../runtime/check.js";
+import { ensureRuntime } from "../runtime/installer.js";
+import { shutdown } from "../telemetry/posthog.js";
+import { printLogo } from "./index.js";
+export async function installSoftware(name) {
+    printLogo();
+    p.intro("mthds setup");
+    if (name !== "pipelex") {
+        p.log.error(`Unknown software: ${name}`);
+        p.log.info("Available software: pipelex");
+        p.outro("Done");
+        process.exit(1);
+    }
+    if (isPipelexInstalled()) {
+        p.log.success("pipelex is already installed.");
+        p.outro("Done");
+        await shutdown();
+        return;
+    }
+    await ensureRuntime();
+    p.log.success("pipelex installed successfully.");
+    p.outro("Done");
+    await shutdown();
+}
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,SAAS,EAAE,CAAC;IACZ,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAEvB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,kBAAkB,EAAE,EAAE,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAChB,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,MAAM,aAAa,EAAE,CAAC;IACtB,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,MAAM,QAAQ,EAAE,CAAC;AACnB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+export interface MthdsConfig {
+    anonymousId: string;
+}
+export declare function loadConfig(): MthdsConfig;

package/dist/config.js

@@ -0,0 +1,21 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+const CONFIG_DIR = join(homedir(), ".pipelex");
+const CONFIG_FILE = join(CONFIG_DIR, "mthds.json");
+export function loadConfig() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    if (existsSync(CONFIG_FILE)) {
+        const raw = readFileSync(CONFIG_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    const config = {
+        anonymousId: randomUUID(),
+    };
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), "utf-8");
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAMnD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAgB;QAC1B,WAAW,EAAE,UAAU,EAAE;KAC1B,CAAC;IAEF,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/postinstall.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/postinstall.js

@@ -0,0 +1,4 @@
+import { trackEvent, shutdown } from "./telemetry/posthog.js";
+trackEvent("installed");
+await shutdown();
+//# sourceMappingURL=postinstall.js.map

package/dist/postinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postinstall.js","sourceRoot":"","sources":["../src/postinstall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE9D,UAAU,CAAC,WAAW,CAAC,CAAC;AACxB,MAAM,QAAQ,EAAE,CAAC"}

package/dist/runtime/check.d.ts

@@ -0,0 +1,2 @@
+export declare function isUvInstalled(): boolean;
+export declare function isPipelexInstalled(): boolean;

package/dist/runtime/check.js

@@ -0,0 +1,23 @@
+import { execFileSync } from "node:child_process";
+export function isUvInstalled() {
+    try {
+        execFileSync("uv", ["--version"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isPipelexInstalled() {
+    try {
+        const output = execFileSync("uv", ["tool", "list"], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return output.includes("pipelex");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/runtime/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/runtime/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE;YAClD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/runtime/installer.d.ts

@@ -0,0 +1 @@
+export declare function ensureRuntime(): Promise<void>;

package/dist/runtime/installer.js

@@ -0,0 +1,39 @@
+import { execSync, execFileSync } from "node:child_process";
+import ora from "ora";
+import { isUvInstalled, isPipelexInstalled } from "./check.js";
+export async function ensureRuntime() {
+    if (!isUvInstalled()) {
+        await installUv();
+    }
+    if (!isPipelexInstalled()) {
+        await installPipelex();
+    }
+}
+async function installUv() {
+    const spinner = ora("Installing uv runtime...").start();
+    try {
+        execSync("curl -LsSf https://astral.sh/uv/install.sh | sh", {
+            stdio: "ignore",
+            shell: "/bin/sh",
+        });
+        spinner.succeed("uv installed");
+    }
+    catch (error) {
+        spinner.fail("Failed to install uv");
+        throw new Error("Could not install uv. Please install it manually: https://docs.astral.sh/uv/getting-started/installation/");
+    }
+}
+async function installPipelex() {
+    const spinner = ora("Setting up pipelex runtime...").start();
+    try {
+        execFileSync("uv", ["tool", "install", "pipelex"], {
+            stdio: "ignore",
+        });
+        spinner.succeed("pipelex installed");
+    }
+    catch (error) {
+        spinner.fail("Failed to install pipelex");
+        throw new Error("Could not install pipelex via uv. Try manually: uv tool install pipelex");
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/runtime/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/runtime/installer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,MAAM,SAAS,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,OAAO,GAAG,GAAG,CAAC,0BAA0B,CAAC,CAAC,KAAK,EAAE,CAAC;IACxD,IAAI,CAAC;QACH,QAAQ,CAAC,iDAAiD,EAAE;YAC1D,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,2GAA2G,CAC5G,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,+BAA+B,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,IAAI,CAAC;QACH,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE;YACjD,KAAK,EAAE,QAAQ;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,yEAAyE,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/runtime/spawn.d.ts

@@ -0,0 +1 @@
+export declare function spawnPipelex(args: string[]): Promise<number>;

package/dist/runtime/spawn.js

@@ -0,0 +1,16 @@
+import { spawn } from "node:child_process";
+export function spawnPipelex(args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("pipelex", args, {
+            stdio: "inherit",
+            shell: false,
+        });
+        child.on("error", (err) => {
+            reject(new Error(`Failed to start pipelex: ${err.message}`));
+        });
+        child.on("close", (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/runtime/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../src/runtime/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;YACnC,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/supabase/client.d.ts

@@ -0,0 +1,4 @@
+import type { Database } from "./types.js";
+export declare const supabase: import("@supabase/supabase-js").SupabaseClient<Database, "public", "public", never, {
+    PostgrestVersion: "12";
+}>;

package/dist/supabase/client.js

@@ -0,0 +1,5 @@
+import { createClient } from "@supabase/supabase-js";
+const SUPABASE_URL = "https://nnusulwfrelkuejkdgif.supabase.co";
+const SUPABASE_KEY = "sb_publishable_7nx0iaNVuAQ7z1hZnuwKEQ_1L_xBZxn";
+export const supabase = createClient(SUPABASE_URL, SUPABASE_KEY);
+//# sourceMappingURL=client.js.map

package/dist/supabase/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/supabase/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,MAAM,YAAY,GAAG,0CAA0C,CAAC;AAChE,MAAM,YAAY,GAChB,gDAAgD,CAAC;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAW,YAAY,EAAE,YAAY,CAAC,CAAC"}

package/dist/supabase/methods.d.ts

@@ -0,0 +1,2 @@
+import type { Method } from "./types.js";
+export declare function fetchMethodBySlug(slug: string): Promise<Method | null>;

package/dist/supabase/methods.js

@@ -0,0 +1,12 @@
+import { supabase } from "./client.js";
+export async function fetchMethodBySlug(slug) {
+    const { data, error } = await supabase
+        .from("methods")
+        .select("*")
+        .eq("name", slug)
+        .single();
+    if (error || !data)
+        return null;
+    return data;
+}
+//# sourceMappingURL=methods.js.map

package/dist/supabase/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/supabase/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY;IAEZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ;SACnC,IAAI,CAAC,SAAS,CAAC;SACf,MAAM,CAAC,GAAG,CAAC;SACX,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC;SAChB,MAAM,EAAE,CAAC;IAEZ,IAAI,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/supabase/types.d.ts

@@ -0,0 +1,25 @@
+export interface Method {
+    id: string;
+    name: string;
+    description: string | null;
+    content: string | null;
+    version: string | null;
+    repository: string | null;
+    dependencies: string | null;
+    installs: number;
+    created_at: string;
+}
+export interface Database {
+    public: {
+        Tables: {
+            methods: {
+                Row: Method;
+                Insert: Omit<Method, "id" | "created_at" | "installs">;
+                Update: Partial<Omit<Method, "id">>;
+            };
+        };
+        Views: Record<string, never>;
+        Functions: Record<string, never>;
+        Enums: Record<string, never>;
+    };
+}

package/dist/supabase/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/supabase/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/supabase/types.ts"],"names":[],"mappings":""}

package/dist/telemetry/posthog.d.ts

@@ -0,0 +1,2 @@
+export declare function trackMethodInstall(methodId: string): void;
+export declare function shutdown(): Promise<void>;

package/dist/telemetry/posthog.js

@@ -0,0 +1,35 @@
+import { PostHog } from "posthog-node";
+const POSTHOG_API_KEY = "phc_ylV9FzMiQDyGgtd5nJn0Cc2OkyHAobfj7xDhYloH5IA";
+const POSTHOG_HOST = "https://eu.i.posthog.com";
+let client = null;
+function isDisabled() {
+    return process.env["DISABLE_TELEMETRY"] === "1";
+}
+function getClient() {
+    if (isDisabled())
+        return null;
+    if (!client) {
+        client = new PostHog(POSTHOG_API_KEY, { host: POSTHOG_HOST });
+    }
+    return client;
+}
+export function trackMethodInstall(methodId) {
+    const posthog = getClient();
+    if (!posthog)
+        return;
+    posthog.capture({
+        distinctId: "anonymous",
+        event: "method_installed",
+        properties: {
+            method: methodId,
+            timestamp: new Date().toISOString(),
+        },
+    });
+}
+export async function shutdown() {
+    if (client) {
+        await client.shutdown();
+        client = null;
+    }
+}
+//# sourceMappingURL=posthog.js.map

package/dist/telemetry/posthog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAC1E,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD,IAAI,MAAM,GAAmB,IAAI,CAAC;AAElC,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,GAAG,CAAC;AAClD,CAAC;AAED,SAAS,SAAS;IAChB,IAAI,UAAU,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO;IAErB,OAAO,CAAC,OAAO,CAAC;QACd,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "mthds",
+  "version": "0.0.1",
+  "description": "CLI for composable methods for AI agents. Turn your knowledge processes into executable methods.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mthds": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "files": [
+    "dist/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.0",
+    "@supabase/supabase-js": "^2.95.3",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "ora": "^8.2.0",
+    "posthog-node": "^4.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "typescript": "^5.7.3"
+  }
+}