@limrun/cli 0.3.0 → 0.4.0

package/README.md

@@ -35,11 +35,12 @@ The CLI stores configuration in `~/.lim/config.yaml`. This file is compatible wi
 
 Every command supports these flags:
 
-| Flag | Description |
-|------|-------------|
-| `--api-key <value>` | API key (also reads `LIM_API_KEY` env var) |
-| `--json` | Output as JSON instead of human-readable tables |
-| `--help` | Show help for any command |
+| Flag                | Description                                     |
+| ------------------- | ----------------------------------------------- |
+| `--api-key <value>` | API key (also reads `LIM_API_KEY` env var)      |
+| `--json`            | Output as JSON instead of human-readable tables |
+| `--quiet`           | Suppress intermediate logs and print only the final result |
+| `--help`            | Show help for any command                       |
 
 ## Command Structure
 
@@ -67,14 +68,16 @@ You can always provide an ID explicitly to target a specific instance:
 lim ios screenshot -o test.png --id ios_def456
 ```
 
-**Top-level shortcuts** are available for common actions — the platform is auto-detected from the instance ID prefix:
+For repeatable scripts and LLM agents, prefer explicit platform commands plus an explicit `--id` once you have it:
 
 ```bash
-lim screenshot --id ios_abc123   # Works for both iOS and Android
-lim tap 100 200 --id ios_abc123  # Auto-detects platform from ID prefix
-lim delete ios_abc123       # Auto-detects resource type from ID prefix
+lim ios get ios_abc123 --json
+lim ios screenshot --id ios_abc123 -o screenshot.png
+lim android tap --id android_abc123 100 200
 ```
 
+This avoids relying on locally cached "last created" state and keeps the target platform explicit.
+
 ## Commands
 
 - [iOS](#ios) — Create, manage, and interact with iOS instances
@@ -93,6 +96,7 @@ lim ios create          # Create a new iOS instance
 lim ios list            # List all ready iOS instances
 lim ios get <ID>        # Get details of a specific instance
 lim ios delete <ID>     # Delete an instance
+lim ios info            # Get device info from a running instance
 ```
 
 #### Create Options
@@ -116,19 +120,19 @@ lim ios create --region us-west --display-name "CI Test" --label env=ci --rm
 
 **Flags for `ios create`:**
 
-| Flag | Description |
-|------|-------------|
-| `--rm` | Auto-delete the instance on exit (Ctrl+C) |
-| `--model <iphone\|ipad\|watch>` | Simulator device model |
-| `--xcode` | Attach a Xcode build sandbox to the iOS instance |
-| `--region <value>` | Region for the instance (e.g. `us-west`) |
-| `--display-name <value>` | Human-readable name |
-| `--label <key=value>` | Labels (repeatable). Used for filtering and reuse |
-| `--hard-timeout <duration>` | Max lifetime (e.g. `1m`, `10m`, `3h`). Default: none |
-| `--inactivity-timeout <duration>` | Idle timeout. Default: `3m` |
-| `--reuse-if-exists` | Reuse an existing instance with matching labels/region |
-| `--install <file>` | Local file to install (auto-uploads, repeatable) |
-| `--install-asset <name>` | Asset name to install (repeatable) |
+| Flag                              | Description                                            |
+| --------------------------------- | ------------------------------------------------------ |
+| `--rm`                            | Auto-delete the instance on exit (Ctrl+C)              |
+| `--model <iphone\|ipad\|watch>`   | Simulator device model                                 |
+| `--xcode`                         | Attach a Xcode build sandbox to the iOS instance       |
+| `--region <value>`                | Region for the instance (e.g. `us-west`)               |
+| `--display-name <value>`          | Human-readable name                                    |
+| `--label <key=value>`             | Labels (repeatable). Used for filtering and reuse      |
+| `--hard-timeout <duration>`       | Max lifetime (e.g. `1m`, `10m`, `3h`). Default: none   |
+| `--inactivity-timeout <duration>` | Idle timeout. Default: `3m`                            |
+| `--reuse-if-exists`               | Reuse an existing instance with matching labels/region |
+| `--install <file>`                | Local file to install (auto-uploads, repeatable)       |
+| `--install-asset <name>`          | Asset name to install (repeatable)                     |
 
 #### List and Filter
 
@@ -147,24 +151,40 @@ lim ios get <ID>                               # Single instance details
 All interaction commands accept an optional `--id`. When omitted, the last created iOS instance is used.
 
 ```bash
+# Device info
+lim ios info
+lim ios info --json
+
 # Screenshots
 lim ios screenshot -o screenshot.png
 lim ios screenshot                      # Output base64 to stdout
 
 # Tapping
 lim ios tap 100 200
-lim ios tap-element --label "Submit"
-lim ios tap-element --accessibility-id btn_ok
+lim ios tap-element --ax-label "Submit"
+lim ios tap-element --ax-unique-id btn_ok
 
 # Text input
 lim ios type "Hello World"
-lim ios type "search query" --press-enter
+lim ios type "search query" --enter
 lim ios press-key enter
 lim ios press-key a --modifier shift
 
 # Scrolling
 lim ios scroll down --amount 500
 
+# Batch multiple actions in one call
+lim ios perform --action type=tap,x=100,y=200 --action 'type=typeText,text=Hello World'
+lim ios perform --action type=wait,durationMs=500 --action type=pressKey,key=enter
+lim ios perform --file ./actions.yaml
+
+# actions.yaml
+- type: tap
+  x: 100
+  y: 200
+- type: typeText
+  text: "Hello World"
+
 # UI inspection
 lim ios element-tree
 lim ios element-tree | jq '.'
@@ -172,6 +192,13 @@ lim ios element-tree | jq '.'
 # Open URLs / deep links
 lim ios open-url https://example.com
 lim ios open-url myapp://settings
+
+# Low-level simulator access
+lim ios simctl -- listapps booted
+lim ios xcrun -- --sdk iphonesimulator --show-sdk-version
+lim ios xcodebuild -- -version
+lim ios cp payload.json ./fixtures/payload.json
+lim ios lsof
 ```
 
 #### App Management (iOS only)
@@ -180,6 +207,8 @@ lim ios open-url myapp://settings
 # Install an app (local file auto-uploads, or use URL)
 lim ios install-app ./MyApp.ipa
 lim ios install-app https://example.com/app.ipa
+lim ios install-app https://example.com/app.ipa --md5 <hex-digest>
+lim ios install-app ./MyApp.ipa --launch-mode RelaunchIfRunning
 
 # Launch / terminate
 lim ios launch-app com.example.myapp
@@ -194,10 +223,14 @@ lim ios list-apps
 
 ```bash
 # Tail recent logs
-lim ios log com.example.myapp --lines 50
+lim ios app-log com.example.myapp --tail 50
 
 # Stream logs continuously (Ctrl+C to stop)
-lim ios log com.example.myapp -f
+lim ios app-log com.example.myapp --follow
+
+# Stream full simulator syslog
+lim ios syslog
+lim ios syslog --json
 ```
 
 #### Video Recording
@@ -210,12 +243,17 @@ lim ios record stop -o recording.mp4
 lim ios record stop --presigned-url https://example.com/upload
 ```
 
-#### Xcode Integration
+#### Built App Sync (iOS only)
 
 ```bash
-# Sync/build use the current directory if no path is provided; pass instance IDs with --id (requires --xcode on create)
-lim ios sync ./MyProject
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
+# Sync a built .app bundle to the current iOS instance
+lim ios sync ./Build/Products/Debug-iphonesimulator/MyApp.app
+
+# Re-sync on changes and relaunch if the app is already running
+lim ios sync ./MyApp.app --watch --launch-mode RelaunchIfRunning
+
+# Tune the delta-sync cache and patch size
+lim ios sync ./MyApp.app --basis-cache-dir ./.limsync-cache --max-patch-bytes 2097152
 ```
 
 ---
@@ -232,14 +270,14 @@ lim android delete <ID>  # Delete an instance
 #### Create Options
 
 ```bash
-# Basic (with ADB tunnel and scrcpy streaming)
+# Basic (prints a Console URL you can open in the browser)
 lim android create
 
 # With apps pre-installed
 lim android create --install ./my-app.apk --install ./another.apk
 
-# Without streaming
-lim android create --no-stream
+# Create without opening an ADB tunnel
+lim android create --no-connect
 
 # Full options
 lim android create --region us-west --display-name "CI Test" --label env=ci --rm
@@ -247,11 +285,12 @@ lim android create --region us-west --display-name "CI Test" --label env=ci --rm
 
 **Android-specific flags:**
 
-| Flag | Description |
-|------|-------------|
-| `--[no-]connect` | Start ADB tunnel (default: true) |
-| `--[no-]stream` | Launch scrcpy for visual control (default: true) |
-| `--adb-path <path>` | Path to `adb` binary (default: `adb`) |
+| Flag                | Description                                      |
+| ------------------- | ------------------------------------------------ |
+| `--[no-]connect`    | Start an ADB tunnel immediately (default: true)  |
+| `--adb-path <path>` | Path to `adb` binary (default: `adb`)            |
+
+`lim android create` always prints a Console URL such as `https://console.limrun.com/stream/android_...` that you can open in the browser for live viewing. For automation, `--no-connect` is usually the safest default.
 
 #### Device Interaction
 
@@ -264,14 +303,18 @@ lim android screenshot -o screenshot.png
 # Tapping
 lim android tap 100 200
 lim android tap-element --resource-id com.example:id/button
+lim android tap-element --content-desc "Sign In button"
 lim android tap-element --text "Sign In"
+lim android find-element --resource-id com.example:id/button --json
 
 # Text input
 lim android type "Hello World"
+lim android type "Hello World" --resource-id com.example:id/search_input
 lim android press-key enter
 
 # Scrolling
 lim android scroll down --amount 500
+lim android scroll down --resource-id com.example:id/list --amount 500
 
 # UI inspection
 lim android element-tree
@@ -284,6 +327,7 @@ lim android open-url https://example.com
 
 # Video recording
 lim android record start
+lim android record start --quality 8
 lim android record stop
 lim android record stop -o recording.mp4
 lim android record stop --presigned-url https://example.com/upload
@@ -317,12 +361,15 @@ lim xcode delete <ID>     # Delete an instance
 # Create with options
 lim xcode create --rm --region us-west --hard-timeout 1h
 
-# Sync and build
-lim xcode sync ./MyProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace
+# Build (automatically syncs the project path first)
+lim xcode build ./MyProject --scheme MyApp --workspace MyApp.xcworkspace
 
 # Build and upload artifact
-lim xcode build --scheme MyApp --upload my-app-build
+lim xcode build ./MyProject --scheme MyApp --upload my-app-build
+
+# Tune sync cache, patch size, or ignore additional paths
+lim xcode sync ./MyProject --watch --basis-cache-dir ./.limsync-cache --max-patch-bytes 2097152
+lim xcode sync ./MyProject --ignore "\\.xcuserdata/" --ignore "^DerivedData/"
 ```
 
 ---
@@ -338,13 +385,15 @@ lim asset push ./my-app.ipa -n custom-name
 
 # Download a file
 lim asset pull asset_abc123
-lim asset pull my-app.apk
 lim asset pull asset_abc123 -o ./downloads
+lim asset list --name my-app.apk --json
+lim asset pull asset_abc123
 
 # List assets
 lim asset list
 lim asset list --name my-app
 lim asset list --download-url
+lim asset list --include-app-store
 
 # Get a specific asset
 lim asset list asset_abc123
@@ -386,7 +435,7 @@ This makes sessions essential for interactive workflows, AI agent loops, and any
 #### Session Commands
 
 ```bash
-# Start a session (defaults to last created instance)
+# Start a session (defaults to the last remembered iOS instance, otherwise Android, then Xcode)
 lim session start
 
 # Or specify an instance explicitly
@@ -407,13 +456,14 @@ lim session stop --id ios_abc123
 lim session stop --all
 ```
 
-If only one session is active, `lim session stop` (no ID) stops it automatically.
+If only one session is active, `lim session stop` (no ID) stops it automatically. For scripts and agents, prefer `--id` explicitly so the target instance is unambiguous.
 
 #### How It Works
 
 Each `lim session start` spawns an independent background daemon that:
+
 - Holds a persistent WebSocket connection to that specific instance
-- Listens on its own Unix socket at `/tmp/lim-sessions/<instance-id>/`
+- Listens on its own Unix socket under `~/.lim/sessions/<hashed-instance-id>/`
 - All interaction commands automatically detect the matching session and route through it
 - Multiple sessions run in parallel with no shared state
 
@@ -426,9 +476,9 @@ lim session start
 # Fast interaction loop — each command takes ~50ms
 lim ios launch-app com.example.myapp
 lim ios element-tree | jq '.tree'
-lim ios tap-element --label "Login"
+lim ios tap-element --ax-label "Login"
 lim ios type "user@example.com"
-lim ios tap-element --label "Submit"
+lim ios tap-element --ax-label "Submit"
 lim ios screenshot -o after-login.png
 
 lim session stop
@@ -482,7 +532,7 @@ done
 # Tear down
 lim session stop --all
 for ID in "${IDS[@]}"; do
-  lim delete $ID
+  lim ios delete $ID
 done
 ```
 
@@ -504,26 +554,23 @@ lim ios create --xcode
 #   Xcode Sandbox: https://...limrun.net/v1/sandbox_.../xcode
 #   (sandbox URL is cached locally for sync/build to use)
 
-# 2. Sync your project code to the Xcode sandbox
-lim ios sync ./MyProject
-
-# 3. Build — the app is auto-installed on the simulator
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
+# 2. Build — automatically syncs your project code first, then auto-installs on the simulator
+lim xcode build ./MyProject --id ios_abc123 --scheme MyApp --workspace MyApp.xcworkspace
 
-# 4. Start a session for fast device interaction
+# 3. Start a session for fast device interaction
 lim session start
 
-# 5. Test the built app on the simulator (~50ms per command)
+# 4. Test the built app on the simulator (~50ms per command)
 lim ios launch-app com.example.myapp
 lim ios element-tree | jq '.'
 lim ios screenshot -o built-app.png
 
-# 6. Clean up
+# 5. Clean up
 lim session stop
 lim ios delete ios_abc123
 ```
 
-> **Note:** The Xcode sandbox URL is only returned when the instance is created — not on subsequent `list` calls. The CLI caches it locally at `~/.lim/instances/` so that `sync` and `build` can find it. This means `sync`/`build` must run on the same machine where `ios create --xcode` was executed.
+> **Note:** `lim xcode build` already syncs the project path you pass before invoking `xcodebuild`, so you do not need to call `lim xcode sync` first. The Xcode sandbox URL is only returned when the instance is created — not on subsequent `list` calls. The CLI caches it locally at `~/.lim/instances/` so that build workflows can find it. This means `build` must run on the same machine where `ios create --xcode` was executed.
 
 #### Option B: Standalone Xcode Instance
 
@@ -533,37 +580,19 @@ Use this when you only need to build (no simulator needed), or when you want to
 # 1. Create a standalone Xcode instance
 lim xcode create --rm
 
-# 2. Sync and build
-lim xcode sync ./MyProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace
+# 2. Build (automatically syncs the project path first)
+lim xcode build ./MyProject --scheme MyApp --workspace MyApp.xcworkspace
 
 # 3. Upload build artifact
-lim xcode build --scheme MyApp --upload my-app-build
+lim xcode build ./MyProject --scheme MyApp --upload my-app-build
 
 # 4. Download the artifact
 lim asset pull my-app-build -o ./build-output
 ```
 
-#### Sync Options
-
-```bash
-# Sync the current directory
-lim ios sync
-
-# Watch mode (re-syncs on file changes)
-lim ios sync ./MyProject --watch
+#### Build Behavior
 
-# One-shot sync (default)
-lim ios sync ./MyProject
-
-# Explicitly disable watch mode
-lim ios sync ./MyProject --no-watch
-
-# Sync without installing
-lim ios sync ./MyProject --no-install
-```
-
-The sync automatically ignores build artifacts (`build/`, `DerivedData/`, `.build/`), dependency folders (`Pods/`, `Carthage/Build/`, `.swiftpm/`), and user-specific files (`xcuserdata/`, `.dSYM/`).
+`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/`).
 
 ---
 
@@ -577,10 +606,10 @@ The CLI reads configuration from multiple sources (in order of precedence):
 
 **Config file keys:**
 
-| Key | Default | Description |
-|-----|---------|-------------|
-| `api-key` | — | Your Limrun API key |
-| `api-endpoint` | `https://api.limrun.com` | API base URL |
+| Key                | Default                      | Description             |
+| ------------------ | ---------------------------- | ----------------------- |
+| `api-key`          | —                            | Your Limrun API key     |
+| `api-endpoint`     | `https://api.limrun.com`     | API base URL            |
 | `console-endpoint` | `https://console.limrun.com` | Console URL (for login) |
 
 ---
@@ -598,8 +627,8 @@ lim android list --json | jq '.[].metadata.id'
 
 # Use in scripts
 INSTANCE_ID=$(lim ios create --json | jq -r '.metadata.id')
-lim ios screenshot -o test.png
-lim delete $INSTANCE_ID
+lim ios screenshot --id $INSTANCE_ID -o test.png
+lim ios delete $INSTANCE_ID
 ```
 
 ---
@@ -621,7 +650,7 @@ lim ios screenshot -o test-result.png
 
 # Clean up
 lim session stop
-lim delete ios_abc123
+lim ios delete ios_abc123
 ```
 
 ### AI Agent Automation
@@ -637,16 +666,16 @@ lim session start
 # Agent can interact at high speed
 lim ios tap 200 400
 lim ios type "test@example.com"
-lim ios tap-element --label "Sign In"
+lim ios tap-element --ax-label "Sign In"
 lim ios screenshot -o result.png
 lim ios element-tree --json > ui-state.json
 
 # Tail logs (non-streaming works through session too)
-lim ios log com.example.myapp --lines 20
+lim ios app-log com.example.myapp --tail 20
 
 # Clean up
 lim session stop
-lim delete $ID
+lim ios delete $ID
 ```
 
 ### Remote Build + Test on iOS Simulator
@@ -655,9 +684,8 @@ lim delete $ID
 # Single instance: Xcode sandbox + iOS simulator
 ID=$(lim ios create --xcode --json | jq -r '.metadata.id')
 
-# Sync, build, and test
-lim ios sync ./MyiOSProject
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
+# Build and test (build automatically syncs the project path first)
+lim xcode build ./MyiOSProject --id $ID --scheme MyApp --workspace MyApp.xcworkspace
 
 # Verify the built app on the simulator
 lim session start
@@ -667,7 +695,7 @@ lim ios element-tree | grep "Welcome"
 lim ios screenshot -o test-result.png
 lim session stop
 
-lim delete $ID
+lim ios delete $ID
 ```
 
 ### Build-Only with Artifact Upload
@@ -675,9 +703,9 @@ lim delete $ID
 ```bash
 lim xcode create --rm --reuse-if-exists --label project=myapp
 
-lim xcode sync ./MyiOSProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace --upload myapp-latest
-lim asset pull myapp-latest -o ./build-output
+lim xcode build ./MyiOSProject --scheme MyApp --workspace MyApp.xcworkspace --upload myapp-latest
+lim asset list --name myapp-latest --json
+lim asset pull asset_abc123 -o ./build-output
 ```
 
 ---

package/bin/run.js

@@ -1,8 +1,63 @@
 #!/usr/bin/env node
 
-const oclif = require('@oclif/core');
+const { flush } = require('@oclif/core');
+const { Config } = require('@oclif/core/config');
+const { handle } = require('@oclif/core/errors');
+const { Help, standardizeIDFromArgv } = require('@oclif/core/help');
+const { run } = require('@oclif/core/run');
 
-oclif
-  .execute({ dir: __dirname, args: process.argv.slice(2) })
-  .then(oclif.flush)
-  .catch(oclif.Errors.handle);
+function isUsageError(error) {
+  return typeof error?.message === 'string' && error.message.includes('\nSee more help with --help');
+}
+
+async function inferCommandArgv(argv) {
+  const config = await Config.load(__dirname);
+  const normalizedArgv = standardizeIDFromArgv([...argv], config);
+  const normalizedCommandId = normalizedArgv[0];
+
+  if (normalizedCommandId && config.findCommand(normalizedCommandId)) {
+    return { commandArgv: normalizedCommandId.split(':'), config };
+  }
+
+  const positionalPrefix = [];
+  for (const token of argv) {
+    if (token === '--' || token.startsWith('-')) break;
+    positionalPrefix.push(token);
+  }
+
+  for (let i = positionalPrefix.length; i > 0; i -= 1) {
+    const commandId = positionalPrefix.slice(0, i).join(':');
+    if (config.findCommand(commandId)) {
+      return { commandArgv: commandId.split(':'), config };
+    }
+  }
+
+  return { commandArgv: undefined, config };
+}
+
+async function handleError(error) {
+  if (!isUsageError(error)) {
+    await handle(error);
+    return;
+  }
+
+  error.message = error.message.replace(/\nSee more help with --help$/, '');
+
+  const { commandArgv, config } = await inferCommandArgv(process.argv.slice(2));
+  if (!commandArgv) {
+    await handle(error);
+    return;
+  }
+
+  console.error(typeof error.render === 'function' ? error.render() : error.message);
+  console.error();
+
+  const help = new Help(config, {
+    ...(config.pjson.oclif.helpOptions ?? config.pjson.helpOptions),
+    sendToStderr: true,
+  });
+  await help.showHelp(commandArgv);
+  process.exitCode = error.oclif?.exit ?? 1;
+}
+
+run(process.argv.slice(2), __dirname).catch(handleError).finally(flush);

package/dist/base-command.d.ts

@@ -4,12 +4,18 @@ export declare abstract class BaseCommand extends Command {
     static baseFlags: {
         '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>;
     };
     private _client?;
     protected get client(): Limrun;
     private _parsedFlags?;
     protected get parsedFlags(): Record<string, unknown> | undefined;
     protected setParsedFlags(flags: Record<string, unknown>): void;
+    protected isJsonEnabled(): boolean;
+    protected isQuietEnabled(): boolean;
+    protected shouldSuppressInfo(): boolean;
+    protected info(message?: string): void;
+    protected output(message?: string): void;
     protected withAuth<T>(fn: () => Promise<T>): Promise<T>;
     protected outputTable(headers: string[], rows: string[][]): void;
     protected outputJson(data: unknown): void;

package/dist/base-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,MAA+B,MAAM,aAAa,CAAC;AAO1D,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;MASd;IAEF,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,SAAS,KAAK,MAAM,IAAI,MAAM,CAc7B;IAED,OAAO,CAAC,YAAY,CAAC,CAA0B;IAE/C,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/D;IAED,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAI9C,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB7D,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAgBhE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKtD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAO5D"}
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,MAA+B,MAAM,aAAa,CAAC;AAO1D,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;;MAed;IAEF,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,SAAS,KAAK,MAAM,IAAI,MAAM,CAc7B;IAED,OAAO,CAAC,YAAY,CAAC,CAA0B;IAE/C,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/D;IAED,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,SAAS,CAAC,aAAa,IAAI,OAAO;IAIlC,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,kBAAkB,IAAI,OAAO;IAIvC,SAAS,CAAC,IAAI,CAAC,OAAO,SAAK,GAAG,IAAI;IAMlC,SAAS,CAAC,MAAM,CAAC,OAAO,SAAK,GAAG,IAAI;cAIpB,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB7D,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAgBhE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKtD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAO5D"}

package/dist/base-command.js

@@ -60,6 +60,23 @@ class BaseCommand extends core_1.Command {
     setParsedFlags(flags) {
         this._parsedFlags = flags;
     }
+    isJsonEnabled() {
+        return Boolean(this.parsedFlags?.json);
+    }
+    isQuietEnabled() {
+        return Boolean(this.parsedFlags?.quiet);
+    }
+    shouldSuppressInfo() {
+        return this.isJsonEnabled() || this.isQuietEnabled();
+    }
+    info(message = '') {
+        if (!this.shouldSuppressInfo()) {
+            super.log(message);
+        }
+    }
+    output(message = '') {
+        super.log(message);
+    }
     async withAuth(fn) {
         try {
             return await fn();
@@ -67,9 +84,9 @@ class BaseCommand extends core_1.Command {
         catch (err) {
             if (err instanceof api_1.AuthenticationError) {
                 const config = (0, config_1.readConfig)();
-                this.log('Session expired. Logging in...');
+                this.info('Session expired. Logging in...');
                 await (0, auth_1.login)(config.consoleEndpoint, VERSION);
-                this.log('You are logged in now.');
+                this.info('You are logged in now.');
                 // Reset client so it picks up the new key
                 this._client = undefined;
                 return fn();
@@ -87,14 +104,14 @@ class BaseCommand extends core_1.Command {
                 });
                 return obj;
             });
-            this.log(JSON.stringify(objects, null, 2));
+            this.output(JSON.stringify(objects, null, 2));
         }
         else {
-            this.log((0, formatting_1.renderTable)(headers, rows));
+            this.output((0, formatting_1.renderTable)(headers, rows));
         }
     }
     outputJson(data) {
-        this.log(JSON.stringify(data, null, 2));
+        this.output(JSON.stringify(data, null, 2));
     }
     consoleStreamUrl(instanceId) {
         const baseUrl = (0, config_1.readConfig)().consoleEndpoint.replace(/\/+$/, '');
@@ -115,11 +132,15 @@ class BaseCommand extends core_1.Command {
 exports.BaseCommand = BaseCommand;
 BaseCommand.baseFlags = {
     'api-key': core_1.Flags.string({
-        description: 'API key for authentication',
+        description: 'API key to use for this command. Overrides the saved login and can also be provided via LIM_API_KEY.',
         env: 'LIM_API_KEY',
     }),
     json: core_1.Flags.boolean({
-        description: 'Output as JSON',
+        description: 'Output structured JSON instead of human-readable tables or plain text when the command supports it.',
+        default: false,
+    }),
+    quiet: core_1.Flags.boolean({
+        description: 'Suppress intermediate human-readable logs and only emit the final result.',
         default: false,
     }),
 };