@limrun/cli 0.6.2 → 0.7.0

package/README.md

@@ -33,7 +33,7 @@ The CLI stores configuration in `~/.lim/config.yaml`. This file is compatible wi
 
 ## Global Flags
 
-Every command supports these flags:
+Most commands support these flags (exceptions: `lim skills install` does not take `--api-key` because it does not talk to the API):
 
 | Flag                | Description                                                |
 | ------------------- | ---------------------------------------------------------- |
@@ -86,6 +86,7 @@ This avoids relying on locally cached "last created" state and keeps the target
 - [Assets](#assets) — Upload and download files (APKs, IPAs, etc.)
 - [Sessions](#sessions) — Persistent connections for fast, interactive device control
 - [Xcode Build Pipeline](#xcode-build-pipeline) — Sync code and run xcodebuild remotely
+- [Skills](#skills) — Install Limrun skills for AI coding agents (Claude Code, Cursor, Codex)
 
 ---
 
@@ -613,6 +614,55 @@ Provide `--certificate-p12`, `--certificate-password`, and `--provisioning-profi
 
 ---
 
+### Skills
+
+Install Limrun skills into the native skills directory of AI coding agents (Claude Code, Cursor, Codex). After installation, the agent auto-discovers the skill and triggers it when you ask things like "build the iOS app" or "show me a screenshot."
+
+```bash
+# Interactive: prompts for agents (with detected ones pre-checked) and scope
+lim skills install
+
+# Non-interactive
+lim skills install --agents claude --scope project
+lim skills install --agents claude --agents cursor --scope project
+lim skills install --agents codex --scope global
+
+# Overwrite existing skill files (otherwise the command refuses on non-interactive runs)
+lim skills install --agents claude --scope project --force
+
+# Machine-readable output for scripts
+lim skills install --agents claude --scope project --json
+```
+
+**Flags:**
+
+| Flag                        | Description                                                                                  |
+| --------------------------- | -------------------------------------------------------------------------------------------- |
+| `--agents <id>`             | Target agent. Repeat to select multiple. One of: `claude`, `cursor`, `codex`.                |
+| `--scope <project\|global>` | `project` writes into the current directory; `global` writes into the user's home directory. |
+| `--force`                   | Overwrite existing skill files without confirmation.                                         |
+| `--json`                    | Emit structured JSON instead of the human summary.                                           |
+| `--quiet`                   | Suppress non-result output.                                                                  |
+
+**Install paths:**
+
+| Agent       | Project                   | Global                                                                     |
+| ----------- | ------------------------- | -------------------------------------------------------------------------- |
+| Claude Code | `.claude/skills/<skill>/` | `$CLAUDE_CONFIG_DIR/skills/<skill>/` (default `~/.claude/skills/<skill>/`) |
+| Cursor      | `.agents/skills/<skill>/` | `~/.agents/skills/<skill>/`                                                |
+| Codex       | `.codex/skills/<skill>/`  | `$CODEX_HOME/skills/<skill>/` (default `~/.codex/skills/<skill>/`)         |
+
+**Behavior:**
+
+- The command compares bundled vs existing content byte-for-byte. Identical content is reported as `Unchanged` (no writes).
+- Different content: in interactive mode you are asked to confirm each overwrite; in non-interactive mode the command refuses unless `--force` is passed.
+- Non-interactive runs are all-or-nothing: if any selected target conflicts and `--force` is not set, no files are written for any target, and the command exits with status 1.
+- Ctrl-C cancellation at any prompt exits cleanly without writing.
+
+Cursor reads `.agents/skills/` natively, so we install there rather than `.cursor/skills/`. As a bonus, the same install reaches OpenCode and any other tool that follows the AGENTS.md convention - no extra menu options needed.
+
+---
+
 ## Configuration
 
 The CLI reads configuration from multiple sources (in order of precedence):

package/dist/commands/android/get.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/android/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,OAAO,SAAiD;IAC/D,MAAM,CAAC,WAAW,SACmI;IACrJ,MAAM,CAAC,QAAQ,WAAkF;IAEjG,MAAM,CAAC,IAAI;;MAKT;IAEF,MAAM,CAAC,KAAK;;;;;MAAgC;IAEtC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB3B"}
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../src/commands/android/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,OAAO,SAAiD;IAC/D,MAAM,CAAC,WAAW,SACmI;IACrJ,MAAM,CAAC,QAAQ,WAAkF;IAEjG,MAAM,CAAC,IAAI;;MAKT;IAEF,MAAM,CAAC,KAAK;;;;;MAAgC;IAEtC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAuB3B"}

package/dist/commands/android/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/android/get.ts"],"names":[],"mappings":";;AAAA,sCAAmC;AACnC,qDAAiD;AAEjD,MAAqB,UAAW,SAAQ,0BAAW;IAejD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC7E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,QAAQ,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC5D,IAAI,CAAC,MAAM,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,UAAU,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC3E,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM;oBAAE,IAAI,CAAC,MAAM,CAAC,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9E,IAAI,QAAQ,CAAC,MAAM,CAAC,eAAe;oBAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;gBAC1G,IAAI,eAAe;oBAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,eAAe,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;;AAnCM,kBAAO,GAAG,6CAA6C,CAAC;AACxD,sBAAW,GAChB,kJAAkJ,CAAC;AAC9I,mBAAQ,GAAG,CAAC,+BAA+B,EAAE,2CAA2C,CAAC,CAAC;AAE1F,eAAI,GAAG;IACZ,EAAE,EAAE,WAAI,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,8EAA8E;QAC3F,QAAQ,EAAE,KAAK;KAChB,CAAC;CACH,CAAC;AAEK,gBAAK,GAAG,EAAE,GAAG,0BAAW,CAAC,SAAS,EAAE,CAAC;kBAbzB,UAAU"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/android/get.ts"],"names":[],"mappings":";;AAAA,sCAAmC;AACnC,qDAAiD;AAEjD,MAAqB,UAAW,SAAQ,0BAAW;IAejD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,gBAAgB,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC7E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,QAAQ,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC5D,IAAI,CAAC,MAAM,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,UAAU,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC3E,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM;oBAAE,IAAI,CAAC,MAAM,CAAC,YAAY,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC9E,IAAI,QAAQ,CAAC,MAAM,CAAC,eAAe;oBACjC,IAAI,CAAC,MAAM,CAAC,sBAAsB,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;gBACvE,IAAI,eAAe;oBAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB,eAAe,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;;AApCM,kBAAO,GAAG,6CAA6C,CAAC;AACxD,sBAAW,GAChB,kJAAkJ,CAAC;AAC9I,mBAAQ,GAAG,CAAC,+BAA+B,EAAE,2CAA2C,CAAC,CAAC;AAE1F,eAAI,GAAG;IACZ,EAAE,EAAE,WAAI,CAAC,MAAM,CAAC;QACd,WAAW,EAAE,8EAA8E;QAC3F,QAAQ,EAAE,KAAK;KAChB,CAAC;CACH,CAAC;AAEK,gBAAK,GAAG,EAAE,GAAG,0BAAW,CAAC,SAAS,EAAE,CAAC;kBAbzB,UAAU"}

package/dist/commands/skills/install.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class SkillsInstall extends Command {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static flags: {
+        agents: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private runInner;
+    private emitOutput;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/skills/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/skills/install.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AA4L7C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,OAAO;IAChD,MAAM,CAAC,OAAO,SAAgD;IAC9D,MAAM,CAAC,WAAW,SAC6K;IAC/L,MAAM,CAAC,QAAQ,WAIb;IACF,MAAM,CAAC,KAAK;;;;;;MAsBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAWZ,QAAQ;IA2GtB,OAAO,CAAC,UAAU;CAiCnB"}

package/dist/commands/skills/install.js

@@ -0,0 +1,325 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const prompts_1 = __importDefault(require("prompts"));
+const core_1 = require("@oclif/core");
+const skills_1 = require("../../lib/skills");
+const SKILL_NAME = 'limrun-ios';
+const SKIPPED_REASON_CONFLICT = 'existing content differs; re-run with --force to overwrite';
+const SKIPPED_REASON_BLOCKED = 'blocked: another target requires --force to proceed';
+const SKIPPED_REASON_DECLINED = 'user declined overwrite confirmation';
+class PromptCancelled extends Error {
+    constructor() {
+        super('cancelled');
+        this.name = 'PromptCancelled';
+    }
+}
+function detectAgentsForScope(scope) {
+    const detected = new Set();
+    for (const id of skills_1.AGENT_IDS) {
+        const agent = skills_1.AGENTS[id];
+        for (const p of agent.detectionPaths(scope)) {
+            if (fs_1.default.existsSync(p)) {
+                detected.add(id);
+                break;
+            }
+        }
+    }
+    return detected;
+}
+async function promptAgents(preselected) {
+    // Loop to enforce "at least one agent" without crashing.
+    while (true) {
+        // `prompts` does not expose the multiselect cursor in onState - the state
+        // event only carries {value, aborted, exited}. Track cursor ourselves by
+        // listening to keypress events on stdin and mirror prompts' own dispatch
+        // (see prompts/lib/util/action.js and multiselect.js):
+        //   - up / k  : wrap (cursor === 0 ? last : cursor - 1)
+        //   - down / j / tab : wrap (cursor === last ? 0 : cursor + 1)
+        //   - ctrl+a  : first
+        //   - ctrl+e  : last
+        // Anything else (page nav, home/end) is rare for a 3-row list and not
+        // tracked here; the worst case is the same as the previous clamp bug.
+        let cursor = 0;
+        const onKeypress = (_str, key) => {
+            if (!key || !key.name)
+                return;
+            if (key.meta && key.name !== 'escape')
+                return;
+            const last = skills_1.AGENT_IDS.length - 1;
+            if (key.ctrl) {
+                if (key.name === 'a')
+                    cursor = 0;
+                else if (key.name === 'e')
+                    cursor = last;
+                return;
+            }
+            if (key.name === 'up' || key.name === 'k') {
+                cursor = cursor === 0 ? last : cursor - 1;
+            }
+            else if (key.name === 'down' || key.name === 'j' || key.name === 'tab') {
+                cursor = cursor === last ? 0 : cursor + 1;
+            }
+        };
+        process.stdin.on('keypress', onKeypress);
+        let response;
+        try {
+            response = await (0, prompts_1.default)({
+                type: 'multiselect',
+                name: 'agents',
+                message: 'Which agents do you want to set up?',
+                instructions: false,
+                choices: skills_1.AGENT_IDS.map((id) => ({
+                    title: skills_1.AGENTS[id].displayName,
+                    value: id,
+                    selected: preselected.has(id),
+                })),
+                hint: 'Space to toggle, Enter to confirm (Enter alone picks the highlighted agent)',
+            }, {
+                onCancel: () => {
+                    throw new PromptCancelled();
+                },
+            });
+        }
+        finally {
+            process.stdin.off('keypress', onKeypress);
+        }
+        let picked = (response.agents ?? []);
+        // If the user hit Enter without toggling anything, treat the highlighted
+        // row as their pick. Saves a Space keystroke for the common single-agent case.
+        if (picked.length === 0 && cursor >= 0 && cursor < skills_1.AGENT_IDS.length) {
+            picked = [skills_1.AGENT_IDS[cursor]];
+        }
+        if (picked.length > 0) {
+            process.stderr.write(`  Selected: ${picked.map((id) => skills_1.AGENTS[id].displayName).join(', ')}\n`);
+            return picked;
+        }
+        // Re-prompt with a visible inline warning (should not be reachable now).
+        process.stderr.write('Select at least one agent.\n');
+    }
+}
+async function promptScope() {
+    const response = await (0, prompts_1.default)({
+        type: 'select',
+        name: 'scope',
+        message: 'Install location?',
+        choices: [
+            { title: 'Project', value: 'project', description: 'Install into the current directory' },
+            { title: 'Global', value: 'global', description: 'Install into your home directory' },
+        ],
+        initial: 0,
+    }, {
+        onCancel: () => {
+            throw new PromptCancelled();
+        },
+    });
+    return response.scope;
+}
+async function promptOverwrite(targetPath) {
+    const response = await (0, prompts_1.default)({
+        type: 'confirm',
+        name: 'ok',
+        message: `Overwrite existing ${targetPath}?`,
+        initial: false,
+    }, {
+        onCancel: () => {
+            throw new PromptCancelled();
+        },
+    });
+    return Boolean(response.ok);
+}
+function humanPath(absolutePath, scope) {
+    if (scope !== 'project') {
+        return absolutePath;
+    }
+    const relative = path_1.default.relative(process.cwd(), absolutePath);
+    if (relative.startsWith('..') || path_1.default.isAbsolute(relative)) {
+        return absolutePath;
+    }
+    return relative;
+}
+function statusLabel(status) {
+    switch (status) {
+        case 'installed':
+            return 'Installed';
+        case 'updated':
+            return 'Updated';
+        case 'unchanged':
+            return 'Unchanged';
+        case 'skipped':
+            return 'Skipped';
+    }
+}
+class SkillsInstall extends core_1.Command {
+    async run() {
+        try {
+            await this.runInner();
+        }
+        catch (err) {
+            if (err instanceof PromptCancelled) {
+                this.exit(130);
+            }
+            throw err;
+        }
+    }
+    async runInner() {
+        const { flags } = await this.parse(SkillsInstall);
+        const interactive = process.stdin.isTTY === true && !flags.json && !flags.quiet;
+        let agents;
+        let scope;
+        if (flags.agents && flags.agents.length > 0) {
+            agents = Array.from(new Set(flags.agents));
+        }
+        else if (interactive) {
+            // Pre-check based on project-local presence only. Global installs of
+            // agents (e.g. ~/.claude on a dev machine) are too weak a signal to
+            // auto-select them for this specific project's install.
+            agents = await promptAgents(detectAgentsForScope('project'));
+        }
+        else {
+            this.error('--agents requires at least one of: claude, cursor, codex.', { exit: 2 });
+        }
+        if (flags.scope) {
+            scope = flags.scope;
+        }
+        else if (interactive) {
+            scope = await promptScope();
+        }
+        else {
+            this.error('Specify --agents and --scope in non-interactive mode.', { exit: 2 });
+        }
+        const source = (0, skills_1.sourceSkillMd)(this.config, SKILL_NAME);
+        if (!fs_1.default.existsSync(source)) {
+            this.error(`Bundled skill source missing at ${source}.`, { exit: 1 });
+        }
+        // Phase 1: Plan.
+        const planned = agents.map((id) => {
+            const agent = skills_1.AGENTS[id];
+            const target = (0, skills_1.targetSkillMd)(agent, scope, SKILL_NAME);
+            const { kind } = (0, skills_1.planSkillFileCopy)(source, target);
+            return { agent, scope, source, target, kind };
+        });
+        // Phase 2: Confirm.
+        const results = [];
+        const anyConflict = planned.some((t) => t.kind === 'conflict');
+        if (anyConflict && !flags.force && !interactive) {
+            // Non-interactive + conflict + no force: all-or-nothing. Skip all targets.
+            for (const t of planned) {
+                results.push({
+                    agent: t.agent.id,
+                    scope: t.scope,
+                    path: t.target,
+                    status: 'skipped',
+                    reason: t.kind === 'conflict' ? SKIPPED_REASON_CONFLICT : SKIPPED_REASON_BLOCKED,
+                });
+            }
+            if (!flags.json) {
+                // --quiet still suppresses the human summary, but a hard refusal needs to be visible.
+                process.stderr.write('Existing skill files would be overwritten. Re-run with --force, or run interactively to confirm per target.\n');
+            }
+            this.emitOutput(results, flags);
+            this.exit(1);
+        }
+        // Decide final status per target (no writes yet).
+        const finalDecisions = [];
+        for (const t of planned) {
+            if (t.kind === 'install') {
+                finalDecisions.push({ target: t, status: 'installed' });
+            }
+            else if (t.kind === 'unchanged') {
+                finalDecisions.push({ target: t, status: 'unchanged' });
+            }
+            else if (flags.force) {
+                finalDecisions.push({ target: t, status: 'updated' });
+            }
+            else {
+                // Interactive conflict without --force: prompt per target.
+                const displayPath = humanPath(t.target, t.scope);
+                const ok = await promptOverwrite(displayPath);
+                if (ok) {
+                    finalDecisions.push({ target: t, status: 'updated' });
+                }
+                else {
+                    finalDecisions.push({
+                        target: t,
+                        status: 'skipped',
+                        reason: SKIPPED_REASON_DECLINED,
+                    });
+                }
+            }
+        }
+        // Phase 3: Apply.
+        for (const decision of finalDecisions) {
+            if (decision.status === 'installed' || decision.status === 'updated') {
+                (0, skills_1.applySkillFileCopy)(decision.target.source, decision.target.target);
+            }
+            results.push({
+                agent: decision.target.agent.id,
+                scope: decision.target.scope,
+                path: decision.target.target,
+                status: decision.status,
+                ...(decision.reason ? { reason: decision.reason } : {}),
+            });
+        }
+        this.emitOutput(results, flags);
+    }
+    emitOutput(results, flags) {
+        if (flags.json) {
+            this.log(JSON.stringify({
+                skill: SKILL_NAME,
+                results,
+            }, null, 2));
+            return;
+        }
+        if (flags.quiet) {
+            return;
+        }
+        // Human summary.
+        this.log('');
+        this.log(`  ${SKILL_NAME}`);
+        const colWidth = Math.max(...results.map((r) => skills_1.AGENTS[r.agent].displayName.length), 'Claude Code'.length);
+        for (const r of results) {
+            const agentLabel = skills_1.AGENTS[r.agent].displayName.padEnd(colWidth);
+            const displayPath = humanPath(r.path, r.scope);
+            const reason = r.reason ? `  (${r.reason})` : '';
+            this.log(`    ${agentLabel}  ->  ${displayPath}    ${statusLabel(r.status)}${reason}`);
+        }
+        this.log('');
+    }
+}
+SkillsInstall.summary = 'Install Limrun skills for AI coding agents';
+SkillsInstall.description = 'Copy the bundled Limrun skill into the native skills directory for each selected agent (Claude Code, Cursor, Codex). Pre-checks detected agents and lets you pick project or global scope.';
+SkillsInstall.examples = [
+    '<%= config.bin %> skills install',
+    '<%= config.bin %> skills install --agents claude --agents cursor --scope project',
+    '<%= config.bin %> skills install --agents codex --scope global --force',
+];
+SkillsInstall.flags = {
+    agents: core_1.Flags.string({
+        description: 'Target agent. Repeat to pick multiple.',
+        multiple: true,
+        options: ['claude', 'cursor', 'codex'],
+    }),
+    scope: core_1.Flags.string({
+        description: 'Install scope.',
+        options: ['project', 'global'],
+    }),
+    force: core_1.Flags.boolean({
+        description: 'Overwrite existing skill files without confirmation.',
+        default: false,
+    }),
+    json: core_1.Flags.boolean({
+        description: 'Emit structured JSON output.',
+        default: false,
+    }),
+    quiet: core_1.Flags.boolean({
+        description: 'Suppress non-result output.',
+        default: false,
+    }),
+};
+exports.default = SkillsInstall;
+//# sourceMappingURL=install.js.map

package/dist/commands/skills/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/skills/install.ts"],"names":[],"mappings":";;;;;AAAA,4CAAoB;AACpB,gDAAwB;AACxB,sDAA8B;AAC9B,sCAA6C;AAC7C,6CAU0B;AAE1B,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,uBAAuB,GAAG,4DAA4D,CAAC;AAC7F,MAAM,sBAAsB,GAAG,qDAAqD,CAAC;AACrF,MAAM,uBAAuB,GAAG,sCAAsC,CAAC;AAoBvE,MAAM,eAAgB,SAAQ,KAAK;IACjC;QACE,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,SAAS,oBAAoB,CAAC,KAAY;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAW,CAAC;IACpC,KAAK,MAAM,EAAE,IAAI,kBAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,eAAM,CAAC,EAAE,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,IAAI,YAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACjB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,WAAyB;IACnD,yDAAyD;IACzD,OAAO,IAAI,EAAE,CAAC;QACZ,0EAA0E;QAC1E,yEAAyE;QACzE,yEAAyE;QACzE,uDAAuD;QACvD,wDAAwD;QACxD,+DAA+D;QAC/D,sBAAsB;QACtB,qBAAqB;QACrB,sEAAsE;QACtE,sEAAsE;QACtE,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,GAAsD,EAAE,EAAE;YAC1F,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI;gBAAE,OAAO;YAC9B,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAC9C,MAAM,IAAI,GAAG,kBAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YAClC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG;oBAAE,MAAM,GAAG,CAAC,CAAC;qBAC5B,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG;oBAAE,MAAM,GAAG,IAAI,CAAC;gBACzC,OAAO;YACT,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBAC1C,MAAM,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACzE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC,CAAC;QACF,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QACzC,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAA,iBAAO,EACtB;gBACE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,qCAAqC;gBAC9C,YAAY,EAAE,KAAK;gBACnB,OAAO,EAAE,kBAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC9B,KAAK,EAAE,eAAM,CAAC,EAAE,CAAC,CAAC,WAAW;oBAC7B,KAAK,EAAE,EAAE;oBACT,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;iBAC9B,CAAC,CAAC;gBACH,IAAI,EAAE,6EAA6E;aACpF,EACD;gBACE,QAAQ,EAAE,GAAG,EAAE;oBACb,MAAM,IAAI,eAAe,EAAE,CAAC;gBAC9B,CAAC;aACF,CACF,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAc,CAAC;QAClD,yEAAyE;QACzE,+EAA+E;QAC/E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,kBAAS,CAAC,MAAM,EAAE,CAAC;YACpE,MAAM,GAAG,CAAC,kBAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/F,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,yEAAyE;QACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,MAAM,QAAQ,GAAG,MAAM,IAAA,iBAAO,EAC5B;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,oCAAoC,EAAE;YACzF,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SACtF;QACD,OAAO,EAAE,CAAC;KACX,EACD;QACE,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,IAAI,eAAe,EAAE,CAAC;QAC9B,CAAC;KACF,CACF,CAAC;IACF,OAAO,QAAQ,CAAC,KAAc,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,UAAkB;IAC/C,MAAM,QAAQ,GAAG,MAAM,IAAA,iBAAO,EAC5B;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,sBAAsB,UAAU,GAAG;QAC5C,OAAO,EAAE,KAAK;KACf,EACD;QACE,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,IAAI,eAAe,EAAE,CAAC;QAC9B,CAAC;KACF,CACF,CAAC;IACF,OAAO,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,SAAS,CAAC,YAAoB,EAAE,KAAY;IACnD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,QAAQ,GAAG,cAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,cAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW;YACd,OAAO,WAAW,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAqB,aAAc,SAAQ,cAAO;IAiChD,KAAK,CAAC,GAAG;QACP,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAElD,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAEhF,IAAI,MAAiB,CAAC;QACtB,IAAI,KAAY,CAAC;QAEjB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAc,CAAC;QAC1D,CAAC;aAAM,IAAI,WAAW,EAAE,CAAC;YACvB,qEAAqE;YACrE,oEAAoE;YACpE,wDAAwD;YACxD,MAAM,GAAG,MAAM,YAAY,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,2DAA2D,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,KAAK,GAAG,KAAK,CAAC,KAAc,CAAC;QAC/B,CAAC;aAAM,IAAI,WAAW,EAAE,CAAC;YACvB,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,uDAAuD,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,mCAAmC,MAAM,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,iBAAiB;QACjB,MAAM,OAAO,GAAoB,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACjD,MAAM,KAAK,GAAG,eAAM,CAAC,EAAE,CAAC,CAAC;YACzB,MAAM,MAAM,GAAG,IAAA,sBAAa,EAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YACvD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,0BAAiB,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAE/D,IAAI,WAAW,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAChD,2EAA2E;YAC3E,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE;oBACjB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,IAAI,EAAE,CAAC,CAAC,MAAM;oBACd,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,sBAAsB;iBACjF,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,sFAAsF;gBACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+GAA+G,CAChH,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;QAED,kDAAkD;QAClD,MAAM,cAAc,GAAsE,EAAE,CAAC;QAC7F,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAClC,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1D,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBACvB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACN,2DAA2D;gBAC3D,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;gBACjD,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;gBAC9C,IAAI,EAAE,EAAE,CAAC;oBACP,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;gBACxD,CAAC;qBAAM,CAAC;oBACN,cAAc,CAAC,IAAI,CAAC;wBAClB,MAAM,EAAE,CAAC;wBACT,MAAM,EAAE,SAAS;wBACjB,MAAM,EAAE,uBAAuB;qBAChC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,KAAK,MAAM,QAAQ,IAAI,cAAc,EAAE,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACrE,IAAA,2BAAkB,EAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;gBAC/B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;gBAC5B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;gBAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAEO,UAAU,CAAC,OAAoB,EAAE,KAAwC;QAC/E,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,SAAS,CACZ;gBACE,KAAK,EAAE,UAAU;gBACjB,OAAO;aACR,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,iBAAiB;QACjB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,EACzD,aAAa,CAAC,MAAM,CACrB,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,eAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAChE,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC,GAAG,CAAC,OAAO,UAAU,SAAS,WAAW,OAAO,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;;AAtLM,qBAAO,GAAG,4CAA4C,CAAC;AACvD,yBAAW,GAChB,4LAA4L,CAAC;AACxL,sBAAQ,GAAG;IAChB,kCAAkC;IAClC,kFAAkF;IAClF,wEAAwE;CACzE,CAAC;AACK,mBAAK,GAAG;IACb,MAAM,EAAE,YAAK,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,wCAAwC;QACrD,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC;KACvC,CAAC;IACF,KAAK,EAAE,YAAK,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,gBAAgB;QAC7B,OAAO,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE,YAAK,CAAC,OAAO,CAAC;QACnB,WAAW,EAAE,sDAAsD;QACnE,OAAO,EAAE,KAAK;KACf,CAAC;IACF,IAAI,EAAE,YAAK,CAAC,OAAO,CAAC;QAClB,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,KAAK;KACf,CAAC;IACF,KAAK,EAAE,YAAK,CAAC,OAAO,CAAC;QACnB,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,KAAK;KACf,CAAC;CACH,CAAC;kBA/BiB,aAAa"}

package/dist/lib/skills.d.ts

@@ -0,0 +1,20 @@
+import { type Config } from '@oclif/core';
+export type AgentId = 'claude' | 'cursor' | 'codex';
+export type Scope = 'project' | 'global';
+export declare const AGENT_IDS: AgentId[];
+export interface AgentSpec {
+    id: AgentId;
+    displayName: string;
+    skillsDir(scope: Scope): string;
+    detectionPaths(scope: Scope): string[];
+}
+export declare const AGENTS: Record<AgentId, AgentSpec>;
+export declare function skillsRoot(config: Config): string;
+export declare function sourceSkillMd(config: Config, skillName: string): string;
+export declare function targetSkillMd(agent: AgentSpec, scope: Scope, skillName: string): string;
+export type PlanKind = 'install' | 'unchanged' | 'conflict';
+export declare function planSkillFileCopy(sourceFile: string, targetFile: string): {
+    kind: PlanKind;
+};
+export declare function applySkillFileCopy(sourceFile: string, targetFile: string): void;
+//# sourceMappingURL=skills.d.ts.map

package/dist/lib/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/lib/skills.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzC,eAAO,MAAM,SAAS,EAAE,OAAO,EAAkC,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;IAChC,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CAAC;CACxC;AAcD,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,CAsC7C,CAAC;AAEF,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAE5D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAO5F;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG/E"}

package/dist/lib/skills.js

@@ -0,0 +1,82 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENTS = exports.AGENT_IDS = void 0;
+exports.skillsRoot = skillsRoot;
+exports.sourceSkillMd = sourceSkillMd;
+exports.targetSkillMd = targetSkillMd;
+exports.planSkillFileCopy = planSkillFileCopy;
+exports.applySkillFileCopy = applySkillFileCopy;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+exports.AGENT_IDS = ['claude', 'cursor', 'codex'];
+function claudeGlobalRoot() {
+    const override = process.env.CLAUDE_CONFIG_DIR;
+    if (override)
+        return path_1.default.resolve(override);
+    return path_1.default.join(os_1.default.homedir(), '.claude');
+}
+function codexGlobalRoot() {
+    const override = process.env.CODEX_HOME;
+    if (override)
+        return path_1.default.resolve(override);
+    return path_1.default.join(os_1.default.homedir(), '.codex');
+}
+exports.AGENTS = {
+    claude: {
+        id: 'claude',
+        displayName: 'Claude Code',
+        skillsDir: (scope) => scope === 'project' ?
+            path_1.default.join(process.cwd(), '.claude', 'skills')
+            : path_1.default.join(claudeGlobalRoot(), 'skills'),
+        detectionPaths: (scope) => scope === 'project' ? [path_1.default.join(process.cwd(), '.claude')] : [claudeGlobalRoot()],
+    },
+    cursor: {
+        id: 'cursor',
+        displayName: 'Cursor',
+        // Cursor auto-discovers .agents/skills/ natively, same as .cursor/skills/.
+        // Installing into .agents/skills/ also reaches OpenCode and any other
+        // AGENTS.md-aware tool with a single copy, so prefer the broader path.
+        skillsDir: (scope) => scope === 'project' ?
+            path_1.default.join(process.cwd(), '.agents', 'skills')
+            : path_1.default.join(os_1.default.homedir(), '.agents', 'skills'),
+        // Detect either .cursor/ or .agents/: both are reliable signs the user
+        // is on a tool that auto-loads .agents/skills/.
+        detectionPaths: (scope) => scope === 'project' ?
+            [path_1.default.join(process.cwd(), '.cursor'), path_1.default.join(process.cwd(), '.agents')]
+            : [path_1.default.join(os_1.default.homedir(), '.cursor'), path_1.default.join(os_1.default.homedir(), '.agents')],
+    },
+    codex: {
+        id: 'codex',
+        displayName: 'Codex',
+        skillsDir: (scope) => scope === 'project' ?
+            path_1.default.join(process.cwd(), '.codex', 'skills')
+            : path_1.default.join(codexGlobalRoot(), 'skills'),
+        detectionPaths: (scope) => scope === 'project' ? [path_1.default.join(process.cwd(), '.codex')] : [codexGlobalRoot()],
+    },
+};
+function skillsRoot(config) {
+    return path_1.default.join(config.root, 'skills');
+}
+function sourceSkillMd(config, skillName) {
+    return path_1.default.join(skillsRoot(config), skillName, 'SKILL.md');
+}
+function targetSkillMd(agent, scope, skillName) {
+    return path_1.default.join(agent.skillsDir(scope), skillName, 'SKILL.md');
+}
+function planSkillFileCopy(sourceFile, targetFile) {
+    if (!fs_1.default.existsSync(targetFile)) {
+        return { kind: 'install' };
+    }
+    const sourceBuf = fs_1.default.readFileSync(sourceFile);
+    const targetBuf = fs_1.default.readFileSync(targetFile);
+    return { kind: sourceBuf.equals(targetBuf) ? 'unchanged' : 'conflict' };
+}
+function applySkillFileCopy(sourceFile, targetFile) {
+    fs_1.default.mkdirSync(path_1.default.dirname(targetFile), { recursive: true });
+    fs_1.default.copyFileSync(sourceFile, targetFile);
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limrun/cli",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Use remote XCode, iOS Simulator, Android Emulator and more to build and test apps from Linux, Windows or macOS.",
   "bin": {
     "lim": "./bin/run.js"
@@ -24,19 +24,21 @@
     "test": "jest"
   },
   "dependencies": {
-    "@limrun/api": "0.28.3",
+    "@limrun/api": "0.28.4",
     "@oclif/core": "^4",
     "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
     "dotenv": "^17.4.2",
     "js-yaml": "^4.1.0",
-    "open": "^10.1.0"
+    "open": "^10.1.0",
+    "prompts": "^2.4.2"
   },
   "devDependencies": {
     "@oclif/test": "^4",
     "@types/cli-progress": "^3.11.6",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22",
+    "@types/prompts": "^2.4.9",
     "typescript": "^5.8.3"
   },
   "oclif": {
@@ -59,6 +61,9 @@
       },
       "session": {
         "description": "Manage persistent background sessions for device interaction: start, status, stop. Sessions are used to execute commands on remote devices without the need to reconnect to the device after each command."
+      },
+      "skills": {
+        "description": "Install Limrun skills for AI coding agents (Claude Code, Cursor, Codex). Run `lim skills install` to set up."
       }
     }
   },
@@ -68,6 +73,7 @@
   "files": [
     "dist",
     "bin",
+    "skills",
     "README.md"
   ]
 }

package/skills/limrun-ios/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: limrun-ios
+description: "Replaces xcodebuild with remote XCode and Simulators, plus full iOS UI control. Use when the user wants to build, run, or launch an iOS app, test iOS UI, interact with the simulator (tap, click, type into, scroll), inspect the screen, capture a screenshot, or record a video. Triggers on phrases like 'run it', 'build it', 'test it', 'show me a screenshot', 'launch on simulator', 'tap the button', or 'type into the field'."
+---
+
+# Remote XCode & iOS Simulator
+
+You are an iOS build-and-test operator. Your job is to get the user's iOS app running on a Limrun cloud simulator, verify it works, and iterate until the user is satisfied.
+
+All builds and simulator operations run on Limrun and that's why you can build iOS
+apps from any environments; linux, windows, macos, VM, container etc. Never try to
+use local Xcode, local simulators, or local macOS build tools.
+
+If `lim` CLI is not installed, you can install it with the following:
+
+```bash
+npm install --global @limrun/cli
+```
+
+## Check the CLI for current commands and flags
+
+The CLI is the source of truth for command names, flags, and behavior. Before invoking any `lim` command you have not already used in this session, MUST run its `--help` first. The examples below are happy-path only; this skill intentionally does not embed the full reference because it would rot. Use:
+
+```bash
+lim ios --help                  # list all iOS subcommands
+lim ios <subcommand> --help     # flags and examples for one iOS subcommand
+lim xcode --help                # list all xcode subcommands
+lim xcode <subcommand> --help   # flags and examples for one xcode subcommand
+lim session --help              # list all session subcommands
+lim session <subcommand> --help # flags and examples for one session subcommand
+```
+
+## Build and Reload
+
+First, create an XCode & iOS Simulator pair:
+
+```bash
+# Add label selector depending on your identifiers. For example, Linear issue, repo name etc.
+lim ios create --xcode \
+  --reuse-if-exists \
+  --label issue=<ISSUE ID> \
+  --label repo=<Repo Name> \
+  --label agent=<Your Agent Name>
+```
+
+The command output includes the instance ID (e.g. `ios_abc123`) and a `Signed Stream URL:`. Share that URL with the user so they can watch the simulator while you work. If you have a browser you can drive, open the URL in that browser and notify the user.
+
+### Start a session for fast interaction
+
+Right after creating the instance, start a session so subsequent interaction commands are fast:
+
+```bash
+# ID comes from the create output above. Always pass --id explicitly in agent workflows.
+lim session start --id <instance-id>
+```
+
+Every `tap`, `type`, `element-tree`, `screenshot`, `record`, and `perform` command auto-routes through this session at ~50ms instead of ~2s. `lim ios delete` will auto-stop the session at cleanup; no separate `session stop` step is required.
+
+### Build
+
+Instead of `xcodebuild` command, you MUST use the following to build the iOS app.
+
+```bash
+lim xcode build .
+```
+
+Use `--scheme` and `--workspace` flags if the project has multiple schemes or uses a workspace file. This makes sure the files are synced with the remote xcode and triggers
+a build where the build logs are streamed through stdout and stderr.
+
+Every successful build will automatically re-install the app in iOS Simulator and re-launch it.
+
+## Interacting with the App
+
+Prefer tapping by accessibility identifier, then by label, then by coordinates as a last resort:
+
+```bash
+lim ios tap-element --ax-unique-id startButton
+lim ios tap-element --ax-label "Save"
+lim ios tap 201 450
+```
+
+After every interaction, re-run `element-tree` to confirm the UI transitioned correctly. No sleep is needed between a tap and element-tree.
+
+For text input:
+
+```bash
+lim ios type "hello world"
+```
+
+## Testing Changes
+
+After every build, test new or changed functionality by using interaction commands. Focus on what changed plus a quick smoke test of core flows.
+
+Use element tree for functional assertions (element existence, labels, state changes). Use screenshots only for visual-only properties.
+Use video recording for most accurate interaction tests such as animations, gameplay,
+real experience etc.
+
+Generally, start with getting an element tree:
+
+```bash
+lim ios element-tree
+```
+
+Then if a single action will be taken, just call it. For example:
+
+```bash
+lim ios tap-element --ax-label Continue
+```
+
+If you will take multiple actions, you can create a chain of actions to be executed
+with precise timing.
+
+Some examples:
+
+```bash
+lim ios perform --action type=tap,x=100,y=200 --action "type=typeText,text=Hello World"
+```
+
+```bash
+lim ios perform --action type=wait,durationMs=1000 --action type=pressKey,key=enter
+```
+
+You can write to a file and execute that too:
+
+```bash
+lim ios perform --file ./actions.yaml
+```
+
+Use `lim ios perform --help` for more details on how to use it.
+
+Video recording is available so you can review what the user sees while you are taking actions. For
+any testing involving motion prefer video over screenshots for review.
+
+Always include a demo video in the pull request so that user can see how it works.
+
+Start recording (non-blocking):
+
+```bash
+lim ios record start
+```
+
+Stop and save recording:
+
+```bash
+lim ios record stop -o /tmp/recording.mp4
+```
+
+## Finalize
+
+When you are wrapping up changes, produce a shareable build artifact so the user can test it themselves:
+
+```bash
+ASSET_NAME="<bundle-id-or-pr-number-or-session-identifier>.zip"
+lim xcode build . --upload ${ASSET_NAME}
+```
+
+Then share a preview link with the user (substitute the asset name above):
+
+```
+https://console.limrun.com/preview?asset=${ASSET_NAME}&platform=ios
+```
+
+Always provide this in your last message.
+
+## Cleanup
+
+When the user is satisfied or the conversation is ending, always clean up:
+
+```bash
+lim ios delete
+```
+
+## Gotchas
+
+These are common failure points. Check here first when something goes wrong.
+
+- **Instance ID is optional.** The CLI remembers the last created instance. You only need to pass an ID explicitly when controlling multiple instances.
+- **No sleep needed between `tap-element` and `element-tree`.** The tap blocks until complete.
+- **`element-tree` can be large.** Pipe through `grep` or `jq` to extract what you need rather than dumping the full tree into context.
+- **Build errors are your job to fix.** If a build fails, read the error output, fix the code, and rebuild. Do not ask the user to fix build errors.
+- **Bundle ID discovery.** If you don't know the bundle ID, check the Xcode project files or run `lim ios list-apps` after a successful build.