@agentled/cli 0.6.6 → 0.7.1

package/dist/utils/home-bootstrap.js

@@ -0,0 +1,133 @@
+/**
+ * Bootstrap `~/.agentled/` on `agentled setup` runs.
+ *
+ * Writes:
+ *   ~/.agentled/README.md                  (top-level pointer)
+ *   ~/.agentled/.content-version           (refresh marker)
+ *   ~/.agentled/docs/WORKFLOW-SHAPE.md     (canonical shape)
+ *   ~/.agentled/docs/GETTING-STARTED.md    (5-min first workflow)
+ *   ~/.agentled/docs/GOTCHAS.md            (silent failure modes)
+ *   ~/.agentled/docs/PATTERNS.md           (scaffold index)
+ *   ~/.agentled/examples/scaffolds/*       (copied from packages/cli/scaffolds/)
+ *
+ * **`docs/` and `examples/scaffolds/` are CLI-managed.** When the
+ * bundled `HOME_CONTENT_VERSION` advances past the on-disk marker, the
+ * bootstrap unconditionally rewrites every bundled file — user edits
+ * to those files WILL be overwritten. Treat them as read-only and put
+ * your own notes in `~/.agentled/docs/local/` (never touched) or in
+ * the per-workspace `agentled_<slug>/` folder.
+ *
+ * `config.json` is never touched.
+ *
+ * `HOME_CONTENT_VERSION` is decoupled from the CLI semver — it bumps
+ * only when bundled docs change, so a CLI patch release with no doc
+ * change does NOT trigger a rewrite.
+ *
+ * Idempotent: a re-run with the same marker version is a no-op.
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync, copyFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { bundledScaffoldsDir } from './workspace-folder.js';
+import { HOME_CONTENT_VERSION, HOME_README_MD, WORKFLOW_SHAPE_MD, GETTING_STARTED_MD, GOTCHAS_MD, PATTERNS_MD, } from './agentled-home-content.js';
+const MARKER_FILE = '.content-version';
+function readMarker(homeDir) {
+    const path = join(homeDir, MARKER_FILE);
+    if (!existsSync(path))
+        return null;
+    try {
+        return readFileSync(path, 'utf-8').trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeMarker(homeDir) {
+    writeFileSync(join(homeDir, MARKER_FILE), HOME_CONTENT_VERSION + '\n');
+}
+/**
+ * Compare integer-like marker versions: -1, 0, 1.
+ *
+ * `HOME_CONTENT_VERSION` is intentionally an opaque integer string
+ * ("1", "2", …), but parsed defensively in case a future maintainer
+ * uses a semver-shaped value.
+ */
+function compareVersions(a, b) {
+    const parse = (v) => v.replace(/^v/, '').split('-')[0].split('.').map(n => parseInt(n, 10) || 0);
+    const [a1, a2 = 0, a3 = 0] = parse(a);
+    const [b1, b2 = 0, b3 = 0] = parse(b);
+    if (a1 !== b1)
+        return a1 < b1 ? -1 : 1;
+    if (a2 !== b2)
+        return a2 < b2 ? -1 : 1;
+    if (a3 !== b3)
+        return a3 < b3 ? -1 : 1;
+    return 0;
+}
+function shouldRefresh(homeDir) {
+    const installed = readMarker(homeDir);
+    if (!installed)
+        return true; // first run
+    return compareVersions(installed, HOME_CONTENT_VERSION) < 0;
+}
+/**
+ * Copy bundled scaffold assets into `examples/scaffolds/`. Includes
+ * any `.json` pipeline scaffold and any `.md` companion documentation.
+ * Other extensions are skipped — keep this whitelist tight so a stray
+ * file in `packages/cli/scaffolds/` never lands in user-visible space.
+ */
+function copyBundledScaffolds(targetDir) {
+    const sourceDir = bundledScaffoldsDir();
+    if (!existsSync(sourceDir))
+        return 0;
+    mkdirSync(targetDir, { recursive: true });
+    let count = 0;
+    for (const entry of readdirSync(sourceDir)) {
+        if (!entry.endsWith('.json') && !entry.endsWith('.md'))
+            continue;
+        const src = join(sourceDir, entry);
+        const dest = join(targetDir, entry);
+        copyFileSync(src, dest);
+        count++;
+    }
+    return count;
+}
+/**
+ * Idempotent. Creates `~/.agentled/` if missing and rewrites the
+ * bundled docs + scaffolds when the on-disk content version is older
+ * than `HOME_CONTENT_VERSION`. Bundled files are unconditionally
+ * overwritten on refresh; never touches `config.json` or any file
+ * under `docs/local/`.
+ */
+export function bootstrapAgentledHome() {
+    const homeDir = join(homedir(), '.agentled');
+    const docsDir = join(homeDir, 'docs');
+    const examplesDir = join(homeDir, 'examples');
+    const scaffoldsDir = join(examplesDir, 'scaffolds');
+    if (!existsSync(homeDir))
+        mkdirSync(homeDir, { recursive: true });
+    if (!shouldRefresh(homeDir)) {
+        return {
+            homeDir,
+            refreshed: false,
+            scaffoldsCopied: 0,
+            version: readMarker(homeDir) ?? HOME_CONTENT_VERSION,
+        };
+    }
+    mkdirSync(docsDir, { recursive: true });
+    mkdirSync(scaffoldsDir, { recursive: true });
+    writeFileSync(join(homeDir, 'README.md'), HOME_README_MD);
+    writeFileSync(join(docsDir, 'WORKFLOW-SHAPE.md'), WORKFLOW_SHAPE_MD);
+    writeFileSync(join(docsDir, 'GETTING-STARTED.md'), GETTING_STARTED_MD);
+    writeFileSync(join(docsDir, 'GOTCHAS.md'), GOTCHAS_MD);
+    writeFileSync(join(docsDir, 'PATTERNS.md'), PATTERNS_MD);
+    const scaffoldsCopied = copyBundledScaffolds(scaffoldsDir);
+    writeMarker(homeDir);
+    return {
+        homeDir,
+        refreshed: true,
+        scaffoldsCopied,
+        version: HOME_CONTENT_VERSION,
+    };
+}
+//# sourceMappingURL=home-bootstrap.js.map

package/dist/utils/home-bootstrap.js.map

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

package/dist/utils/knowledge-probe.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Read `knowledge.company.profile` (and `.products`) from the workspace KG.
+ *
+ * Used by `agentled setup` to decide whether to prompt the user for company
+ * information or skip straight to "workspace already configured". We probe
+ * only the new keys; legacy `.company` / `company.offering` are not checked
+ * — we focus on new clients and keep this clean.
+ *
+ * Uses the typed `AgentledApiClient.getKnowledgeText` surface. Failures are
+ * non-fatal: setup must not break on a network blip or a missing endpoint.
+ */
+import { AgentledApiClient } from '@agentled/core';
+export interface KnowledgeProbeResult {
+    /** Has the user (or an agent) populated the canonical company profile yet? */
+    profilePresent: boolean;
+    productsPresent: boolean;
+    /** Short snippet of the profile if present (first ~120 chars) for the summary line. */
+    profilePreview?: string;
+    /** Set if the probe failed entirely (network, permissions). Treat as "unknown". */
+    error?: string;
+}
+export declare function probeCompanyKnowledge(client: AgentledApiClient): Promise<KnowledgeProbeResult>;
+export declare function summarizeKnowledgeProbe(r: KnowledgeProbeResult): string;

package/dist/utils/knowledge-probe.js

@@ -0,0 +1,57 @@
+/**
+ * Read `knowledge.company.profile` (and `.products`) from the workspace KG.
+ *
+ * Used by `agentled setup` to decide whether to prompt the user for company
+ * information or skip straight to "workspace already configured". We probe
+ * only the new keys; legacy `.company` / `company.offering` are not checked
+ * — we focus on new clients and keep this clean.
+ *
+ * Uses the typed `AgentledApiClient.getKnowledgeText` surface. Failures are
+ * non-fatal: setup must not break on a network blip or a missing endpoint.
+ */
+async function fetchKnowledgeText(client, key) {
+    try {
+        const res = (await client.getKnowledgeText(key));
+        if (!res)
+            return null;
+        // The API returns `content` for upsert/get parity, but tolerate `text`
+        // as a defensive fallback for older response shapes.
+        const value = res.content ?? res.text ?? null;
+        return typeof value === 'string' ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function probeCompanyKnowledge(client) {
+    try {
+        const [profile, products] = await Promise.all([
+            fetchKnowledgeText(client, 'knowledge.company.profile'),
+            fetchKnowledgeText(client, 'knowledge.company.products'),
+        ]);
+        const profilePresent = typeof profile === 'string' && profile.trim().length > 0;
+        const productsPresent = typeof products === 'string' && products.trim().length > 0;
+        return {
+            profilePresent,
+            productsPresent,
+            profilePreview: profilePresent && profile ? profile.trim().slice(0, 120) : undefined,
+        };
+    }
+    catch (err) {
+        return {
+            profilePresent: false,
+            productsPresent: false,
+            error: err?.message ?? String(err),
+        };
+    }
+}
+export function summarizeKnowledgeProbe(r) {
+    if (r.error)
+        return `Could not read workspace knowledge (${r.error}). You can run \`agentled workspace company-profile\` later.`;
+    if (r.profilePresent) {
+        const preview = r.profilePreview ? ` — "${r.profilePreview}${r.profilePreview.length >= 120 ? '…' : ''}"` : '';
+        return `Workspace already configured (knowledge.company.profile is set${preview}).`;
+    }
+    return 'Workspace knowledge is empty — collecting company profile now.';
+}
+//# sourceMappingURL=knowledge-probe.js.map

package/dist/utils/knowledge-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-probe.js","sourceRoot":"","sources":["../../src/utils/knowledge-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,KAAK,UAAU,kBAAkB,CAAC,MAAyB,EAAE,GAAW;IACpE,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAA6D,CAAC;QAC7G,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,uEAAuE;QACvE,qDAAqD;QACrD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;QAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAyB;IACjE,IAAI,CAAC;QACD,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1C,kBAAkB,CAAC,MAAM,EAAE,2BAA2B,CAAC;YACvD,kBAAkB,CAAC,MAAM,EAAE,4BAA4B,CAAC;SAC3D,CAAC,CAAC;QAEH,MAAM,cAAc,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAChF,MAAM,eAAe,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAEnF,OAAO;YACH,cAAc;YACd,eAAe;YACf,cAAc,EAAE,cAAc,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;SACvF,CAAC;IACN,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAChB,OAAO;YACH,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,KAAK;YACtB,KAAK,EAAE,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC;SACrC,CAAC;IACN,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,CAAuB;IAC3D,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,uCAAuC,CAAC,CAAC,KAAK,8DAA8D,CAAC;IACjI,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,OAAO,iEAAiE,OAAO,IAAI,CAAC;IACxF,CAAC;IACD,OAAO,gEAAgE,CAAC;AAC5E,CAAC"}

package/dist/utils/mcp-config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP client detection and config writing for `agentled setup`.
+ *
+ * Lifted from agentled-mcp-server/src/setup.ts so the CLI orchestrates the
+ * full onboarding without depending on the mcp-server's setup flag (which
+ * is being deprecated in favor of `agentled setup`).
+ *
+ * Detects Claude Code, Codex, Claude Desktop, Cursor, Windsurf and writes
+ * the AgentLed MCP server entry into the appropriate config location.
+ */
+export type McpClient = 'claude-code' | 'claude-desktop' | 'codex' | 'cursor' | 'windsurf' | 'unknown';
+export interface McpConfigureResult {
+    client: McpClient;
+    success: boolean;
+    /** Where the config was written (or attempted) */
+    configPath: string | null;
+    /** Manual instructions to print if auto-config failed */
+    fallbackHint?: string;
+}
+export declare function getClientLabel(client: McpClient): string;
+export declare function detectMcpClient(): McpClient;
+/**
+ * Auto-detect the user's MCP client and register the AgentLed MCP server.
+ * Returns a result describing what happened, including a fallback hint when
+ * the client is unknown or the config write failed.
+ */
+export declare function configureMcp(apiKey: string, baseUrl: string): Promise<McpConfigureResult>;

package/dist/utils/mcp-config.js

@@ -0,0 +1,190 @@
+/**
+ * MCP client detection and config writing for `agentled setup`.
+ *
+ * Lifted from agentled-mcp-server/src/setup.ts so the CLI orchestrates the
+ * full onboarding without depending on the mcp-server's setup flag (which
+ * is being deprecated in favor of `agentled setup`).
+ *
+ * Detects Claude Code, Codex, Claude Desktop, Cursor, Windsurf and writes
+ * the AgentLed MCP server entry into the appropriate config location.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { spawn } from 'node:child_process';
+export function getClientLabel(client) {
+    switch (client) {
+        case 'claude-code': return 'Claude Code';
+        case 'claude-desktop': return 'Claude Desktop';
+        case 'codex': return 'Codex';
+        case 'cursor': return 'Cursor';
+        case 'windsurf': return 'Windsurf';
+        default: return 'Unknown';
+    }
+}
+export function detectMcpClient() {
+    if (existsSync(join(homedir(), '.claude')))
+        return 'claude-code';
+    if (existsSync(join(homedir(), '.codex')))
+        return 'codex';
+    const desktop = getClaudeDesktopConfigPath();
+    if (desktop && existsSync(dirname(desktop)))
+        return 'claude-desktop';
+    if (existsSync(join(homedir(), '.cursor')))
+        return 'cursor';
+    if (existsSync(join(homedir(), '.windsurf')))
+        return 'windsurf';
+    return 'unknown';
+}
+function getClaudeDesktopConfigPath() {
+    if (process.platform === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
+    }
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+function getMcpJsonPath(client) {
+    if (client === 'cursor')
+        return join(homedir(), '.cursor', 'mcp.json');
+    if (client === 'windsurf')
+        return join(homedir(), '.windsurf', 'mcp.json');
+    return null;
+}
+function configureClaudeCode(apiKey, baseUrl) {
+    return new Promise(resolve => {
+        try {
+            // Server name must precede -e/--env (Claude Code 2.1+ parser quirk).
+            const child = spawn('claude', [
+                'mcp', 'add',
+                '--transport', 'stdio',
+                '--scope', 'user',
+                'agentled',
+                '-e', `AGENTLED_API_KEY=${apiKey}`,
+                ...(baseUrl !== 'https://www.agentled.app' ? ['-e', `AGENTLED_URL=${baseUrl}`] : []),
+                '--', 'npx', '-y', '@agentled/mcp-server',
+            ], { stdio: 'inherit' });
+            child.on('close', code => resolve(code === 0));
+            child.on('error', () => resolve(false));
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+function configureCodex(apiKey, baseUrl) {
+    return new Promise(resolve => {
+        try {
+            const child = spawn('codex', [
+                'mcp', 'add', 'agentled',
+                '--env', `AGENTLED_API_KEY=${apiKey}`,
+                ...(baseUrl !== 'https://www.agentled.app' ? ['--env', `AGENTLED_URL=${baseUrl}`] : []),
+                '--', 'npx', '-y', '@agentled/mcp-server',
+            ], { stdio: 'inherit' });
+            child.on('close', code => resolve(code === 0));
+            child.on('error', () => resolve(false));
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}
+function writeMcpJsonConfig(configPath, apiKey, baseUrl) {
+    try {
+        let config = {};
+        if (existsSync(configPath)) {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        const env = { AGENTLED_API_KEY: apiKey };
+        if (baseUrl !== 'https://www.agentled.app')
+            env.AGENTLED_URL = baseUrl;
+        config.mcpServers.agentled = {
+            command: 'npx',
+            args: ['-y', '@agentled/mcp-server'],
+            env,
+        };
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function manualSnippet(apiKey, baseUrl) {
+    const envArgs = baseUrl !== 'https://www.agentled.app'
+        ? `-e AGENTLED_API_KEY=${apiKey} -e AGENTLED_URL=${baseUrl}`
+        : `-e AGENTLED_API_KEY=${apiKey}`;
+    const lines = [
+        'Could not auto-detect your MCP client. Add manually:',
+        '',
+        'Claude Code:',
+        `  claude mcp add --transport stdio --scope user agentled ${envArgs} -- npx -y @agentled/mcp-server`,
+        '',
+        'Codex / Cursor / Windsurf — add to your MCP config JSON:',
+        '  {',
+        '    "agentled": {',
+        '      "command": "npx",',
+        '      "args": ["-y", "@agentled/mcp-server"],',
+        `      "env": { "AGENTLED_API_KEY": "${apiKey}"${baseUrl !== 'https://www.agentled.app' ? `, "AGENTLED_URL": "${baseUrl}"` : ''} }`,
+        '    }',
+        '  }',
+    ];
+    return lines.join('\n');
+}
+/**
+ * Auto-detect the user's MCP client and register the AgentLed MCP server.
+ * Returns a result describing what happened, including a fallback hint when
+ * the client is unknown or the config write failed.
+ */
+export async function configureMcp(apiKey, baseUrl) {
+    const client = detectMcpClient();
+    if (client === 'claude-code') {
+        const ok = await configureClaudeCode(apiKey, baseUrl);
+        return {
+            client,
+            success: ok,
+            configPath: ok ? '~/.claude.json (via `claude mcp add`)' : null,
+            fallbackHint: ok ? undefined : manualSnippet(apiKey, baseUrl),
+        };
+    }
+    if (client === 'codex') {
+        const ok = await configureCodex(apiKey, baseUrl);
+        return {
+            client,
+            success: ok,
+            configPath: ok ? '~/.codex/config (via `codex mcp add`)' : null,
+            fallbackHint: ok ? undefined : manualSnippet(apiKey, baseUrl),
+        };
+    }
+    if (client === 'claude-desktop') {
+        const path = getClaudeDesktopConfigPath();
+        const ok = path ? writeMcpJsonConfig(path, apiKey, baseUrl) : false;
+        return {
+            client,
+            success: ok,
+            configPath: path,
+            fallbackHint: ok ? undefined : manualSnippet(apiKey, baseUrl),
+        };
+    }
+    if (client === 'cursor' || client === 'windsurf') {
+        const path = getMcpJsonPath(client);
+        const ok = path ? writeMcpJsonConfig(path, apiKey, baseUrl) : false;
+        return {
+            client,
+            success: ok,
+            configPath: path,
+            fallbackHint: ok ? undefined : manualSnippet(apiKey, baseUrl),
+        };
+    }
+    return {
+        client: 'unknown',
+        success: false,
+        configPath: null,
+        fallbackHint: manualSnippet(apiKey, baseUrl),
+    };
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/utils/mcp-config.js.map

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

package/dist/utils/skills.d.ts

@@ -12,6 +12,14 @@
  *   - Reads a `version:` frontmatter field from each `SKILL.md`
  *   - Leaves newer or hand-edited skills alone (unless --force)
  *   - Reports status so we can print a one-line summary after `auth login`
+ *
+ * Targets:
+ *   - Claude Code / Claude Desktop → `~/.claude/skills/` (global) or
+ *     `./.claude/skills/` (project) via the `global` option.
+ *   - Codex → `~/.codex/instructions/` via `targetDir` override (set by the
+ *     `agentled setup` orchestrator after detecting a Codex install).
+ *   - Cursor / Windsurf → not auto-installed (no native skills surface);
+ *     the orchestrator skips this step and prints a hint.
  */
 export type SkillInstallOutcome = 'installed' | 'updated' | 'up-to-date' | 'newer-local' | 'hand-edited' | 'forced';
 export interface SkillInstallResult {
@@ -26,17 +34,17 @@ export interface InstallSkillsOptions {
     global?: boolean;
     /** overwrite regardless of version comparison or local edits */
     force?: boolean;
+    /**
+     * Override the target directory entirely. Used by the orchestrator to
+     * route Codex installs to `~/.codex/instructions/` and (in future) any
+     * other client-specific skill location.
+     */
+    targetDir?: string;
 }
-/**
- * Locate the `skills/` directory that ships with @agentled/cli.
- *
- * When running from source (`node dist/index.js`) the layout is:
- *   packages/cli/dist/utils/skills.js  → packages/cli/skills/…
- * When installed globally via npm, the package layout is the same relative
- * structure (`dist/utils/skills.js` → `skills/`).
- */
 export declare function resolveBundledSkillsDir(): string;
 export declare function getSkillsTargetDir(global: boolean): string;
+/** Codex's skill/instruction directory — separate from Claude's. */
+export declare function getCodexInstructionsDir(): string;
 export declare function installSkills(options?: InstallSkillsOptions): SkillInstallResult[];
 export declare function describeSkillsInstall(results: SkillInstallResult[], targetDir: string): string;
 /**

package/dist/utils/skills.js

@@ -12,22 +12,21 @@
  *   - Reads a `version:` frontmatter field from each `SKILL.md`
  *   - Leaves newer or hand-edited skills alone (unless --force)
  *   - Reports status so we can print a one-line summary after `auth login`
+ *
+ * Targets:
+ *   - Claude Code / Claude Desktop → `~/.claude/skills/` (global) or
+ *     `./.claude/skills/` (project) via the `global` option.
+ *   - Codex → `~/.codex/instructions/` via `targetDir` override (set by the
+ *     `agentled setup` orchestrator after detecting a Codex install).
+ *   - Cursor / Windsurf → not auto-installed (no native skills surface);
+ *     the orchestrator skips this step and prints a hint.
  */
 import { existsSync, readFileSync, mkdirSync, readdirSync, statSync, cpSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { homedir } from 'node:os';
-/**
- * Locate the `skills/` directory that ships with @agentled/cli.
- *
- * When running from source (`node dist/index.js`) the layout is:
- *   packages/cli/dist/utils/skills.js  → packages/cli/skills/…
- * When installed globally via npm, the package layout is the same relative
- * structure (`dist/utils/skills.js` → `skills/`).
- */
 export function resolveBundledSkillsDir() {
     const here = fileURLToPath(import.meta.url);
-    // dist/utils/skills.js → package root is two levels up
     const pkgRoot = resolve(dirname(here), '..', '..');
     return join(pkgRoot, 'skills');
 }
@@ -36,14 +35,13 @@ export function getSkillsTargetDir(global) {
         ? join(homedir(), '.claude', 'skills')
         : join(process.cwd(), '.claude', 'skills');
 }
-/**
- * Parse a `version:` field out of the YAML-style frontmatter at the top of a
- * SKILL.md file. Returns null if no frontmatter or no version field is present.
- */
+/** Codex's skill/instruction directory — separate from Claude's. */
+export function getCodexInstructionsDir() {
+    return join(homedir(), '.codex', 'instructions');
+}
 function parseSkillVersion(skillMdPath) {
     try {
         const content = readFileSync(skillMdPath, 'utf-8');
-        // Only inspect frontmatter (between the first two --- delimiters)
         const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
         if (!fmMatch)
             return null;
@@ -54,10 +52,6 @@ function parseSkillVersion(skillMdPath) {
         return null;
     }
 }
-/**
- * Compare two semver-ish version strings. Returns -1, 0, or 1.
- * Handles missing prereleases by treating undefined segments as 0.
- */
 function compareVersions(a, b) {
     const parse = (v) => v.replace(/^v/, '').split('.').map(n => parseInt(n, 10) || 0);
     const [a1, a2 = 0, a3 = 0] = parse(a);
@@ -70,14 +64,6 @@ function compareVersions(a, b) {
         return a3 < b3 ? -1 : 1;
     return 0;
 }
-/**
- * Recursively hash-compare two directories by content. Returns true if the
- * byte contents of every file match (directory structure + file bytes).
- *
- * Used to detect hand-edited installs: if the installed version matches the
- * bundled version but the bytes differ, the user (or a prior agent session)
- * has customised the skill and we should not overwrite without --force.
- */
 function directoriesIdentical(a, b) {
     try {
         const aEntries = readdirSync(a).sort();
@@ -115,7 +101,7 @@ export function installSkills(options = {}) {
     if (!existsSync(sourceDir)) {
         throw new Error(`Bundled skills directory not found at ${sourceDir}`);
     }
-    const targetBase = getSkillsTargetDir(options.global ?? false);
+    const targetBase = options.targetDir ?? getSkillsTargetDir(options.global ?? false);
     const results = [];
     const skills = readdirSync(sourceDir, { withFileTypes: true })
         .filter(d => d.isDirectory())
@@ -199,7 +185,7 @@ export function summarizeForLoginBanner(results, targetDir) {
     const updatable = results.filter(r => r.outcome === 'up-to-date' && r.installedVersion && r.bundledVersion && compareVersions(r.installedVersion, r.bundledVersion) < 0);
     if (fresh.length > 0) {
         const names = fresh.map(r => `${r.skill} v${r.bundledVersion}`).join(', ');
-        return `Installed Claude Code skill: ${names} → ${targetDir}`;
+        return `Installed Agentled skill: ${names} → ${targetDir}`;
     }
     if (stale.length > 0) {
         const r = stale[0];

package/dist/utils/skills.js.map

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

package/dist/utils/version-check.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Best-effort "new version available" check against the npm registry.
+ *
+ * Compares the locally-installed @agentled/cli version (from package.json)
+ * against the latest published on npm and prints a one-line warning if the
+ * user is behind. Never blocks setup on failure — a flaky network or
+ * registry should not prevent first-time onboarding.
+ */
+/**
+ * Read the version field from this package's own package.json. Returns
+ * '0.0.0-dev' as a fallback so a missing/unreadable file doesn't crash setup.
+ */
+export declare function getInstalledCliVersion(): string;
+export interface VersionCheckResult {
+    installed: string;
+    latest: string | null;
+    /** True if the registry returned a version newer than installed. */
+    outdated: boolean;
+    /** Set when the registry could not be reached or parsed. */
+    error?: string;
+}
+export declare function checkCliVersion(): Promise<VersionCheckResult>;
+/** One-line summary suitable for the setup banner. Returns null if there is nothing to say. */
+export declare function summarizeVersionCheck(r: VersionCheckResult): string | null;