ethos-cli 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# Ethos CLI
+
+Commander-based CLI for Ethos agent and table operations.
+
+## Install
+
+```bash
+npm install -g ethos-cli
+```
+
+## Auth
+
+The CLI can connect through your existing browser session:
+
+```bash
+ethos auth login
+ethos auth status
+ethos auth logout
+```
+
+Use `--app-url` if your frontend is not on the default local/prod URL:
+
+```bash
+ethos --api-url http://127.0.0.1:8001 auth login --app-url http://localhost:3001
+```
+
+You can also configure auth with flags or environment variables:
+
+```bash
+export ETHOS_API_URL="https://api.ethos.hello-cluster.com"
+export ETHOS_API_KEY="..."
+export ETHOS_ORG_ID="..."
+```
+
+Every command also accepts `--api-url`, `--api-key`, `--access-token`, `--org-id`, and `--json`.
+
+## Bundled Skills
+
+Installing the CLI also installs bundled Ethos skills into supported local agents
+when they are detected: Claude Code, Codex, and Cursor.
+
+```bash
+ethos skills install
+ethos skills install --agents codex
+ethos skills list
+ethos skills remove
+```
+
+Set `ETHOS_SKIP_SKILLS=1` before install to skip the automatic postinstall sync.
+
+## Agent Commands
+
+```bash
+ethos agents list
+ethos agents get <agent-id>
+
+ethos agents create \
+  --name "Company enricher" \
+  --instructions "Enrich this company from the row context" \
+  --workflow-type company_enrichment \
+  --ability web-search \
+  --ability linkedin-company-lookup \
+  --tool-preset browser
+
+ethos agents configure <agent-id> --workflow-type people_sourcing --clear-abilities
+ethos agents delete <agent-id>
+```
+
+Workflow/table compatibility is shown in `--help`: company tables support company enrichment columns and people sourcing, people tables support person enrichment columns. The CLI sends the configured request and lets backend validation decide the final result.
+
+## Table Commands
+
+```bash
+ethos tables list
+ethos tables get <table-id>
+ethos tables import-csv ./companies.csv --entity-type company
+ethos tables import-csv ./people.csv --entity-type people
+
+ethos tables views list <table-id>
+ethos tables views create <table-id> --name "Qualified companies" --filter <column-id>:contains:example
+ethos tables views configure <table-id> <view-id> --clear-filters
+ethos tables views delete <table-id> <view-id>
+
+ethos tables columns create-agent <table-id> \
+  --name "ICP fit" \
+  --agent-id <agent-id> \
+  --prompt "Score this account" \
+  --output-field score \
+  --output-field reason
+
+ethos tables columns configure <table-id> <column-id> --name "New name"
+ethos tables columns delete <table-id> <column-id>
+ethos tables columns extract-json <table-id> <column-id>
+
+ethos tables rows delete <table-id> <row-id>
+ethos tables rows delete <table-id> 3 --by-index
+ethos tables rows delete <table-id> 1 2 3 --by-index
+
+ethos tables agent-edits apply <table-id> \
+  --instruction "Delete rows that are no longer relevant" \
+  --row-id <focused-row-id>
+
+ethos tables cells set <table-id> <row-id> <column-id> --value "Manual note"
+ethos tables cells set <table-id> <row-id> <column-id> --value '{"score":9}' --value-json
+
+ethos tables runs start <table-id> <column-id> --scope first_5
+ethos tables runs get <run-id>
+ethos tables runs interrupt <run-id>
+
+ethos tables source-people <company-table-id> \
+  --view-id <view-id> \
+  --agent-id <people-sourcing-agent-id> \
+  --input-column <company-domain-column-id> \
+  --targeting-brief "Find funding and finance contacts" \
+  --created-by-codex
+
+ethos tables runs create-people-table <run-id>
+```
+
+When stdout is not a TTY, output is JSON by default so coding agents can parse it reliably.
+Table-detail commands such as `tables get`, `tables import-csv`, and `tables runs create-people-table` include top-level `table_id`, `column_ids`, `row_ids`, and `view_ids` in addition to the full nested objects. `tables source-people` includes top-level `table_id`, `column_id`, and `run_id`.

package/dist/bin/ethos.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+export declare function createEthosProgram(): Command;
+export declare function main(argv?: string[]): Promise<void>;

package/dist/bin/ethos.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import { realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { registerAgents } from "../commands/agents.js";
+import { registerAuth } from "../commands/auth.js";
+import { registerSkills } from "../commands/skills.js";
+import { registerTables } from "../commands/tables.js";
+import { addGlobalOptions } from "../lib/config.js";
+import { printError } from "../lib/output.js";
+const pkg = createRequire(import.meta.url)("../../package.json");
+export function createEthosProgram() {
+    const program = new Command();
+    addGlobalOptions(program
+        .name("ethos")
+        .description("CLI for Ethos workspace and table operations")
+        .version(pkg.version));
+    registerAuth(program);
+    registerAgents(program);
+    registerSkills(program);
+    registerTables(program);
+    return program;
+}
+export async function main(argv = process.argv) {
+    await createEthosProgram().parseAsync(argv);
+}
+function isDirectInvocation() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(fileURLToPath(import.meta.url)) === realpathSync(entry);
+    }
+    catch {
+        return false;
+    }
+}
+if (isDirectInvocation()) {
+    main().catch((error) => {
+        printError(error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=ethos.js.map

package/dist/bin/ethos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ethos.js","sourceRoot":"","sources":["../../src/bin/ethos.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAwB,CAAC;AAExF,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,gBAAgB,CACd,OAAO;SACJ,IAAI,CAAC,OAAO,CAAC;SACb,WAAW,CAAC,8CAA8C,CAAC;SAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CACxB,CAAC;IAEF,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,cAAc,CAAC,OAAO,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAiB,OAAO,CAAC,IAAI;IACtD,MAAM,kBAAkB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,kBAAkB,EAAE,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrB,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/agents.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerAgents(program: Command): void;

package/dist/commands/agents.js

@@ -0,0 +1,162 @@
+import { collect, compactObject, jsonRequest, pathId, withClient } from "../lib/command-helpers.js";
+import { printResult } from "../lib/output.js";
+const workflowTypes = new Set([
+    "company_enrichment",
+    "person_enrichment",
+    "people_sourcing",
+]);
+const abilities = new Set([
+    "web-search",
+    "web-fetch",
+    "browser-use",
+    "ethos-hub",
+    "linkedin-profile-lookup",
+    "linkedin-company-lookup",
+]);
+const toolPresets = new Set(["filesystem", "shell", "browser"]);
+const compatibilityHelp = `
+
+Workflow/table compatibility:
+  company_enrichment agents are intended for company table agent columns.
+  person_enrichment agents are intended for people table agent columns.
+  people_sourcing agents are intended for company tables via "ethos tables source-people".
+  The CLI sends the request as configured; backend validation is the source of truth.`;
+export function registerAgents(program) {
+    const agents = program.command("agents").alias("agent").description("Manage Ethos agents").addHelpText("after", compatibilityHelp);
+    const listCommand = agents.command("list").description("List agents");
+    listCommand.action(async () => {
+        await withClient(listCommand, async (client, config) => {
+            printResult(config, await client.request("/v1/agents"));
+        });
+    });
+    const getCommand = agents.command("get <agent-id>").description("Fetch an agent");
+    getCommand.action(async (agentId) => {
+        await withClient(getCommand, async (client, config) => {
+            printResult(config, await client.request(`/v1/agents/${pathId(agentId)}`));
+        });
+    });
+    const createCommand = addAgentOptions(agents
+        .command("create")
+        .description("Create an agent with workflow type, abilities, skills, tool presets, and instructions")
+        .requiredOption("--name <name>", "agent name")
+        .requiredOption("--instructions <instructions>", "full agent instructions prompt"), { includeClearFlags: false, includeCoreFlags: false });
+    createCommand.action(async () => {
+        await withClient(createCommand, async (client, config) => {
+            const options = createCommand.opts();
+            const body = compactObject({
+                name: options.name,
+                description: options.description,
+                instructions: options.instructions,
+                model: options.model,
+                workflow_type: parseWorkflowType(options.workflowType, "--workflow-type"),
+                abilities: parseAbilities(options.ability, "--ability"),
+                skills: parseStringList(options.skill),
+                tool_presets: parseToolPresets(options.toolPreset, "--tool-preset"),
+            });
+            printResult(config, await client.request("/v1/agents", jsonRequest("POST", body)));
+        });
+    });
+    const configureCommand = addAgentOptions(agents.command("configure <agent-id>").alias("update").description("Update an agent configuration"), { includeClearFlags: true, includeCoreFlags: true });
+    configureCommand.action(async (agentId) => {
+        await withClient(configureCommand, async (client, config) => {
+            const options = configureCommand.opts();
+            const body = compactObject({
+                name: options.name,
+                description: options.description,
+                instructions: options.instructions,
+                model: options.model,
+                workflow_type: parseUpdateWorkflowType(options),
+                abilities: parseUpdateList(options.ability, options.clearAbilities, "--ability", parseAbility),
+                skills: parseUpdateStringList(options.skill, options.clearSkills),
+                tool_presets: parseUpdateList(options.toolPreset, options.clearToolPresets, "--tool-preset", parseToolPreset),
+            });
+            if (Object.keys(body).length === 0) {
+                throw new Error("Pass at least one agent field to configure.");
+            }
+            printResult(config, await client.request(`/v1/agents/${pathId(agentId)}`, jsonRequest("PATCH", body)));
+        });
+    });
+    const deleteCommand = agents.command("delete <agent-id>").description("Delete an agent");
+    deleteCommand.action(async (agentId) => {
+        await withClient(deleteCommand, async (client, config) => {
+            printResult(config, await client.request(`/v1/agents/${pathId(agentId)}`, { method: "DELETE" }));
+        });
+    });
+}
+function addAgentOptions(command, options) {
+    if (options.includeCoreFlags) {
+        command.option("--name <name>", "agent name").option("--instructions <instructions>", "full agent instructions prompt");
+    }
+    command
+        .option("--description <description>", "agent description")
+        .option("--model <model>", "model name")
+        .option("--workflow-type <type>", "company_enrichment, person_enrichment, or people_sourcing")
+        .option("--ability <ability>", "agent ability; repeatable", collect, [])
+        .option("--skill <skill>", "skill name; repeatable", collect, [])
+        .option("--tool-preset <preset>", "filesystem, shell, or browser; repeatable", collect, []);
+    if (options.includeClearFlags) {
+        command
+            .option("--clear-abilities", "replace abilities with an empty list")
+            .option("--clear-skills", "replace skills with an empty list")
+            .option("--clear-tool-presets", "replace tool presets with an empty list")
+            .option("--clear-workflow-type", "set workflow_type to null");
+    }
+    return command.addHelpText("after", compatibilityHelp);
+}
+function parseWorkflowType(value, option) {
+    if (value === undefined)
+        return undefined;
+    if (workflowTypes.has(value))
+        return value;
+    throw new Error(`${option} must be one of company_enrichment, person_enrichment, people_sourcing.`);
+}
+function parseUpdateWorkflowType(options) {
+    if (options.workflowType !== undefined && options.clearWorkflowType) {
+        throw new Error("Use either --workflow-type or --clear-workflow-type, not both.");
+    }
+    if (options.clearWorkflowType)
+        return null;
+    return parseWorkflowType(options.workflowType, "--workflow-type");
+}
+function parseAbilities(values, option) {
+    return parseOptionalList(values, option, parseAbility);
+}
+function parseToolPresets(values, option) {
+    return parseOptionalList(values, option, parseToolPreset);
+}
+function parseStringList(values) {
+    const parsed = cleanList(values);
+    return parsed.length ? parsed : undefined;
+}
+function parseUpdateStringList(values, clear) {
+    if (values?.length && clear)
+        throw new Error("Use either repeated values or the matching --clear flag, not both.");
+    if (clear)
+        return [];
+    return parseStringList(values);
+}
+function parseUpdateList(values, clear, option, parser) {
+    if (values?.length && clear)
+        throw new Error(`Use either ${option} or the matching --clear flag, not both.`);
+    if (clear)
+        return [];
+    return parseOptionalList(values, option, parser);
+}
+function parseOptionalList(values, option, parser) {
+    const parsed = cleanList(values).map((value) => parser(value, option));
+    return parsed.length ? Array.from(new Set(parsed)) : undefined;
+}
+function parseAbility(value, option) {
+    if (abilities.has(value))
+        return value;
+    throw new Error(`${option} must be one of web-search, web-fetch, browser-use, ethos-hub, linkedin-profile-lookup, linkedin-company-lookup.`);
+}
+function parseToolPreset(value, option) {
+    if (toolPresets.has(value))
+        return value;
+    throw new Error(`${option} must be one of filesystem, shell, browser.`);
+}
+function cleanList(values) {
+    return (values || []).map((value) => value.trim()).filter(Boolean);
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

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

package/dist/commands/auth.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerAuth(program: Command): void;

package/dist/commands/auth.js

@@ -0,0 +1,180 @@
+import { spawn } from "node:child_process";
+import { hostname } from "node:os";
+import { authConfigPath, clearStoredAuth, readStoredAuth, writeStoredAuth } from "../lib/auth-store.js";
+import { isJsonMode, resolveApiUrl } from "../lib/config.js";
+import { printResult } from "../lib/output.js";
+export function registerAuth(program) {
+    const auth = program.command("auth").description("Authenticate the Ethos CLI");
+    const loginCommand = auth
+        .command("login")
+        .description("Connect the CLI through your browser session")
+        .option("--app-url <url>", "Ethos web app URL", process.env.ETHOS_APP_URL)
+        .option("--device-name <name>", "display name for this CLI session")
+        .option("--no-open", "print the approval URL without opening a browser")
+        .option("--timeout <seconds>", "seconds to wait for browser approval", "120");
+    loginCommand.action(async () => {
+        const apiUrl = resolveApiUrl(loginCommand);
+        const options = loginCommand.opts();
+        const timeoutSeconds = parseTimeout(options.timeout);
+        const deviceName = options.deviceName || `Ethos CLI on ${hostname() || "this machine"}`;
+        const appUrl = (options.appUrl || inferAppUrl(apiUrl)).replace(/\/+$/, "");
+        const registered = await apiRequest(apiUrl, "/v1/auth/cli/register", {
+            method: "POST",
+            body: {
+                app_url: appUrl,
+                device_name: deviceName,
+            },
+        });
+        if (isJsonMode(loginCommand)) {
+            process.stdout.write(`${JSON.stringify({ success: true, response: { claim_url: registered.claim_url, expires_at: registered.expires_at } }, null, 2)}\n`);
+        }
+        else {
+            process.stdout.write(`Opening browser approval: ${registered.claim_url}\n`);
+        }
+        if (options.open !== false) {
+            openInBrowser(registered.claim_url);
+        }
+        const claimed = await waitForClaim(apiUrl, registered.claim_token, timeoutSeconds);
+        if (!claimed.api_key) {
+            throw new Error("Browser approval completed, but the API did not return a CLI token.");
+        }
+        writeStoredAuth({
+            apiUrl,
+            apiKey: claimed.api_key,
+            orgId: claimed.org_id ?? undefined,
+            userEmail: claimed.user_email ?? undefined,
+            userId: claimed.user_id ?? undefined,
+            apiKeyId: claimed.api_key_id ?? undefined,
+            savedAt: new Date().toISOString(),
+        });
+        printResult({
+            apiUrl,
+            apiKey: claimed.api_key,
+            orgId: claimed.org_id ?? undefined,
+            json: isJsonMode(loginCommand),
+        }, {
+            authenticated: true,
+            api_url: apiUrl,
+            org_id: claimed.org_id,
+            org_name: claimed.org_name,
+            user_email: claimed.user_email,
+            config_path: authConfigPath(),
+        });
+    });
+    const statusCommand = auth.command("status").description("Show the saved CLI auth state");
+    statusCommand.action(async () => {
+        const apiUrl = resolveApiUrl(statusCommand);
+        const stored = readStoredAuth();
+        const storedMatchesApiUrl = stored?.apiUrl.replace(/\/+$/, "") === apiUrl;
+        if (!stored || !storedMatchesApiUrl) {
+            printAuthResult(statusCommand, {
+                authenticated: false,
+                api_url: apiUrl,
+                config_path: authConfigPath(),
+            });
+            return;
+        }
+        const orgs = await apiRequest(apiUrl, "/v1/auth/orgs", {
+            method: "GET",
+            apiKey: stored.apiKey,
+            orgId: stored.orgId,
+        });
+        printAuthResult(statusCommand, {
+            authenticated: true,
+            api_url: apiUrl,
+            org_id: stored.orgId,
+            user_email: stored.userEmail,
+            orgs: orgs.orgs,
+            config_path: authConfigPath(),
+        });
+    });
+    const logoutCommand = auth.command("logout").description("Remove the saved CLI token from this machine");
+    logoutCommand.action(async () => {
+        const removed = clearStoredAuth();
+        printAuthResult(logoutCommand, {
+            authenticated: false,
+            removed,
+            config_path: authConfigPath(),
+        });
+    });
+}
+async function waitForClaim(apiUrl, claimToken, timeoutSeconds) {
+    const deadline = Date.now() + timeoutSeconds * 1000;
+    while (Date.now() <= deadline) {
+        const status = await apiRequest(apiUrl, "/v1/auth/cli/status", {
+            method: "POST",
+            body: {
+                claim_token: claimToken,
+                reveal: true,
+            },
+        });
+        if (status.status === "claimed")
+            return status;
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+    throw new Error("Still waiting for browser approval. Re-run `ethos auth login` when you are ready to try again.");
+}
+async function apiRequest(apiUrl, path, options = { method: "GET" }) {
+    const headers = new Headers();
+    if (options.body !== undefined)
+        headers.set("Content-Type", "application/json");
+    if (options.apiKey)
+        headers.set("Authorization", `Bearer ${options.apiKey}`);
+    if (options.orgId)
+        headers.set("X-Org-Id", options.orgId);
+    const response = await fetch(`${apiUrl}${path}`, {
+        method: options.method,
+        headers,
+        body: options.body === undefined ? undefined : JSON.stringify(options.body),
+    });
+    const envelope = (await response.json());
+    if (!response.ok || envelope.success === false) {
+        throw new Error(getErrorMessage(envelope.error ?? envelope.detail ?? envelope, response.status));
+    }
+    return envelope.response;
+}
+function parseTimeout(value) {
+    const parsed = Number.parseInt(value || "", 10);
+    if (!Number.isFinite(parsed) || parsed < 1)
+        throw new Error("--timeout must be a positive number of seconds.");
+    return Math.min(parsed, 600);
+}
+function inferAppUrl(apiUrl) {
+    try {
+        const url = new URL(apiUrl);
+        if (url.hostname === "localhost" || url.hostname === "127.0.0.1") {
+            url.port = url.port === "8001" ? "3001" : "3000";
+            return url.toString().replace(/\/+$/, "");
+        }
+    }
+    catch {
+        // Fall through to production default.
+    }
+    return "https://ethos.hello-cluster.com";
+}
+function openInBrowser(url) {
+    const command = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    try {
+        const child = spawn(command, args, { detached: true, stdio: "ignore" });
+        child.unref();
+    }
+    catch {
+        // The approval URL was already printed.
+    }
+}
+function printAuthResult(command, response) {
+    const apiUrl = resolveApiUrl(command);
+    printResult({ apiUrl, apiKey: "", json: isJsonMode(command) }, response);
+}
+function getErrorMessage(error, status) {
+    if (typeof error === "string")
+        return error;
+    if (error && typeof error === "object" && "message" in error) {
+        const message = error.message;
+        if (typeof message === "string")
+            return message;
+    }
+    return `API request failed: ${status}`;
+}
+//# sourceMappingURL=auth.js.map

package/dist/commands/auth.js.map

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

package/dist/commands/skills.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerSkills(program: Command): void;

package/dist/commands/skills.js

@@ -0,0 +1,90 @@
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { isJsonMode } from "../lib/config.js";
+import { printResult } from "../lib/output.js";
+import { AGENTS, readLockfile, removeAllSkills, syncSkills, } from "../skills-installer/index.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const SKILLS_DIR = join(here, "..", "..", "skills");
+const pkg = createRequire(import.meta.url)("../../package.json");
+const ALL_AGENTS = Object.keys(AGENTS);
+export function registerSkills(program) {
+    const skills = program
+        .command("skills")
+        .description("Install bundled Ethos skills into supported coding agents. This normally runs during npm install.");
+    const installCommand = skills
+        .command("install")
+        .description("Install bundled Ethos skills into detected agents")
+        .option("-a, --agents <list>", `comma-separated agents (default: auto-detect). Supported: ${ALL_AGENTS.join(", ")}`);
+    installCommand.action(async () => {
+        const result = await syncSkills({
+            bundledSkillsDir: SKILLS_DIR,
+            ethosVersion: pkg.version,
+            agents: parseAgentList(installCommand.opts().agents),
+        });
+        printSkillsResult(installCommand, {
+            label: `Targets: ${result.targetAgents.map((agent) => AGENTS[agent].displayName).join(", ") ||
+                "(none detected - pass --agents to force)"}`,
+            data: {
+                target_agents: result.targetAgents,
+                skipped_agents: result.skippedAgents,
+                installed: result.installed,
+                updated: result.updated,
+                removed: result.removed,
+            },
+        });
+    });
+    const listCommand = skills
+        .command("list")
+        .description("Show Ethos-installed skills and where they live on disk");
+    listCommand.action(async () => {
+        const lock = await readLockfile();
+        const installedSkills = Object.entries(lock.skills).map(([name, entry]) => ({
+            name,
+            installed_at: entry.installedAt,
+            agents: Object.fromEntries(Object.entries(entry.agents).map(([agent, info]) => [agent, info?.path])),
+        }));
+        printSkillsResult(listCommand, {
+            label: installedSkills.length
+                ? `Installed Ethos skills: ${installedSkills.map((skill) => skill.name).join(", ")}`
+                : "No Ethos skills installed. Run `ethos skills install`.",
+            data: {
+                ethos_version: lock.ethosVersion,
+                count: installedSkills.length,
+                skills: installedSkills,
+            },
+        });
+    });
+    const removeCommand = skills
+        .command("remove")
+        .description("Remove every Ethos-installed skill from every agent");
+    removeCommand.action(async () => {
+        const removed = await removeAllSkills();
+        printSkillsResult(removeCommand, {
+            label: removed.length ? `Removed: ${removed.join(", ")}` : "Nothing to remove.",
+            data: { removed },
+        });
+    });
+}
+function parseAgentList(value) {
+    if (!value)
+        return undefined;
+    const agents = value
+        .split(",")
+        .map((part) => part.trim())
+        .filter(Boolean);
+    const parsed = [];
+    for (const agent of agents) {
+        if (ALL_AGENTS.includes(agent)) {
+            parsed.push(agent);
+        }
+        else {
+            throw new Error(`unknown agent: ${agent} (supported: ${ALL_AGENTS.join(", ")})`);
+        }
+    }
+    return parsed;
+}
+function printSkillsResult(command, result) {
+    printResult({ apiUrl: "", apiKey: "", json: isJsonMode(command) }, result);
+}
+//# sourceMappingURL=skills.js.map

package/dist/commands/skills.js.map

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