lim 0.19.4 → 0.19.5

package/README.md

@@ -424,6 +424,9 @@ lim xcode create --rm --region us-west --hard-timeout 1h
 # Build (automatically syncs the project path first)
 lim xcode build ./MyProject --scheme MyApp --workspace MyApp.xcworkspace
 
+# Run a project command (syncs the current directory first)
+lim xcode run -- make api
+
 # Build and upload artifact
 lim xcode build ./MyProject --scheme MyApp --upload my-app-build
 
@@ -670,6 +673,19 @@ lim asset pull my-app-build -o ./build-output
 
 `lim xcode build [PATH]` automatically performs a one-shot code sync for the given project path before invoking `xcodebuild`. The sync step automatically ignores build artifacts (`build/`, `DerivedData/`, `.build/`), dependency folders (`Pods/`, `Carthage/Build/`, `.swiftpm/`), and user-specific files (`xcuserdata/`, `.dSYM/`).
 
+#### Run project commands
+
+`lim xcode run [RELATIVE_CWD] -- <COMMAND...>` syncs the current directory and runs a one-shot command in the Xcode sandbox. The remote working directory defaults to the synced workspace root:
+
+```bash
+lim xcode run -- make api
+lim xcode run apps/api -- make generate
+lim xcode run --env API_ENV=development -- npm run generate
+lim xcode run --no-sync -- mise run build
+```
+
+The sandbox includes Node, Ruby, CMake, Mint, and mise. mise and Mint installs are scoped to the instance's sandbox home. Homebrew is not available because its macOS packages require a shared system prefix; use mise, Mint, SwiftPM, or project-local binaries instead. Commands stream stdout and stderr and return the remote exit code, but do not provide an interactive terminal.
+
 For [XcodeGen](https://github.com/yonaskolb/XcodeGen) projects whose generated `.xcodeproj` is gitignored, the server generates it from your synced `project.yml` automatically before the build — it looks next to a pinned `--project`/`--workspace` path, at the synced folder root, and one directory level down. If your spec has a different name or location, pin it with `--xcodegen-spec <path>`, optionally control the output directory with `--xcodegen-project <dir>`, and anchor relative paths in the spec with `--xcodegen-project-root <dir>`; all paths are relative to the synced folder root and mirror `xcodegen generate --spec/--project/--project-root`. Passing any of these flags always regenerates the project on the server:
 
 ```bash

package/dist/commands/xcode/run.d.ts

@@ -0,0 +1,26 @@
+import { BaseCommand } from '../../base-command';
+export default class XcodeRun extends BaseCommand {
+    static summary: string;
+    static description: string;
+    static examples: string[];
+    static args: {
+        cwd: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        id: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        env: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'no-sync': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'basis-cache-dir': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        ignore: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        include: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'additional-file': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        create: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/xcode/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/commands/xcode/run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAMjD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,OAAO,SAAuC;IACrD,MAAM,CAAC,WAAW,SAC8F;IAEhH,MAAM,CAAC,QAAQ,WAKb;IAEF,MAAM,CAAC,IAAI;;MAMT;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;;;;MAuCV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyD3B"}

package/dist/commands/xcode/run.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const ignore_patterns_1 = require("../../lib/ignore-patterns");
+const duration_1 = require("../../lib/duration");
+const bytes_1 = require("../../lib/bytes");
+const additional_files_1 = require("../../lib/additional-files");
+class XcodeRun extends base_command_1.BaseCommand {
+    async run() {
+        const delimiter = this.argv.indexOf('--');
+        if (delimiter < 0) {
+            this.error('Separate the remote command with `--`, for example: lim xcode run -- make api');
+        }
+        const commandArgs = this.argv.slice(delimiter + 1);
+        if (commandArgs.length === 0) {
+            this.error('A command is required after `--`.');
+        }
+        const { args, flags } = await this.parse(XcodeRun, this.argv.slice(0, delimiter));
+        this.setParsedFlags(flags);
+        const env = parseEnvironmentEntries(flags.env ?? [], (message) => this.error(message));
+        const commandLine = commandArgs.length === 1 ? commandArgs[0] : commandArgs.map(quoteShellArgument).join(' ');
+        await this.withAuth(async () => {
+            const target = await this.resolveXcodeTargetOrCreate(flags.id);
+            const xcodeClient = await this.resolveXcodeClient(target);
+            if (!flags['no-sync']) {
+                const syncPath = process.cwd();
+                this.info(`Syncing ${syncPath} to instance ${target.id}...`);
+                const syncStart = Date.now();
+                const result = await xcodeClient.sync(syncPath, {
+                    watch: false,
+                    install: false,
+                    basisCacheDir: flags['basis-cache-dir'],
+                    ignore: (0, ignore_patterns_1.compileIgnorePatterns)(flags.ignore),
+                    include: (0, ignore_patterns_1.compileIgnorePatterns)(flags.include),
+                    additionalFiles: (0, additional_files_1.parseAdditionalFileFlags)(flags['additional-file']),
+                });
+                const syncDuration = (0, duration_1.formatDurationMs)(Date.now() - syncStart);
+                const syncedSize = result.bytesSent !== undefined ? ` (${(0, bytes_1.formatBytes)(result.bytesSent)} sent)` : '';
+                this.info(`Sync completed in ${syncDuration}${syncedSize}.`);
+            }
+            this.info(`Running in ${args.cwd ?? '.'}: ${commandLine}`);
+            const proc = xcodeClient.run(commandLine, {
+                cwd: args.cwd ?? '.',
+                ...(env && { env }),
+                ...(flags.timeout !== undefined && { timeoutSeconds: flags.timeout }),
+            });
+            proc.stdout.on('data', (line) => process.stdout.write(line + '\n'));
+            proc.stderr.on('data', (line) => process.stderr.write(line + '\n'));
+            const result = await proc;
+            if (result.exitCode !== 0) {
+                if (result.timedOut) {
+                    this.error('Timed out waiting for the command to finish; the remote command may still be running.', { exit: result.exitCode });
+                }
+                this.error(`Command failed with exit code ${result.exitCode}`, { exit: result.exitCode });
+            }
+        });
+    }
+}
+XcodeRun.summary = 'Run a command on an Xcode sandbox';
+XcodeRun.description = 'Sync the current directory, then run a one-shot shell command in the remote workspace with streamed output.';
+XcodeRun.examples = [
+    '<%= config.bin %> xcode run -- make api',
+    '<%= config.bin %> xcode run apps/api -- make generate',
+    '<%= config.bin %> xcode run --env API_ENV=development -- npm run generate',
+    '<%= config.bin %> xcode run --no-sync -- mise run build',
+];
+XcodeRun.args = {
+    cwd: core_1.Args.string({
+        description: 'Remote working directory relative to the synced workspace root. Defaults to ".".',
+        required: false,
+        default: '.',
+    }),
+};
+XcodeRun.flags = {
+    ...base_command_1.BaseCommand.baseFlags,
+    id: core_1.Flags.string({
+        description: 'Xcode instance ID to run on. Defaults to the most recent standalone Xcode target.',
+    }),
+    env: core_1.Flags.string({
+        description: 'Environment variable in KEY=VALUE form. Repeat for multiple variables.',
+        multiple: true,
+        multipleNonGreedy: true,
+    }),
+    timeout: core_1.Flags.integer({
+        description: 'Server-side command timeout in seconds. Defaults to 3600, max 21600.',
+        min: 1,
+        max: 21600,
+    }),
+    'no-sync': core_1.Flags.boolean({
+        description: 'Skip syncing the current directory before running the command.',
+        default: false,
+    }),
+    'basis-cache-dir': core_1.Flags.string({
+        description: 'Directory to use for the client-side delta sync cache.',
+    }),
+    ignore: core_1.Flags.string({
+        description: 'Regular expression to ignore matching relative paths during sync. Repeat for multiple.',
+        multiple: true,
+        multipleNonGreedy: true,
+    }),
+    include: core_1.Flags.string({
+        description: 'Regular expression to force-sync matching relative paths even when gitignored. Repeat for multiple.',
+        multiple: true,
+        multipleNonGreedy: true,
+    }),
+    'additional-file': core_1.Flags.string({
+        description: 'Additional file to sync as localPath=remotePath, for example ~/.netrc=~/.netrc. Repeat for multiple.',
+        multiple: true,
+        multipleNonGreedy: true,
+    }),
+};
+exports.default = XcodeRun;
+function quoteShellArgument(value) {
+    return `'${value.split("'").join("'\"'\"'")}'`;
+}
+function parseEnvironmentEntries(entries, fail) {
+    if (entries.length === 0)
+        return undefined;
+    const env = {};
+    for (const entry of entries) {
+        const separator = entry.indexOf('=');
+        if (separator <= 0) {
+            fail(`Invalid --env value ${JSON.stringify(entry)}; expected KEY=VALUE.`);
+        }
+        const key = entry.slice(0, separator);
+        if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) {
+            fail(`Invalid environment variable name ${JSON.stringify(key)}.`);
+        }
+        env[key] = entry.slice(separator + 1);
+    }
+    return env;
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/xcode/run.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lim",
-  "version": "0.19.4",
+  "version": "0.19.5",
   "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"
@@ -25,7 +25,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@limrun/api": "0.42.2",
+    "@limrun/api": "0.43.0",
     "@oclif/core": "^4",
     "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
@@ -70,7 +70,7 @@
         "description": "Install Limrun skills for AI coding agents (Claude Code, Cursor, Codex). Run `lim skills install` to set up."
       },
       "xcode": {
-        "description": "Execute any task on remote XCode sandboxes: create, list, get, delete, sync, build, attach-simulator"
+        "description": "Execute any task on remote XCode sandboxes: create, list, get, delete, sync, build, run, attach-simulator"
       }
     }
   },