@swmansion/argent 0.6.0 → 0.7.0-next.4

package/README.md

@@ -6,7 +6,7 @@
 </p>
 <br/>
 
-**[Argent](https://argent.swmansion.com)** is an **agentic toolkit** that gives your AI assistant direct access to iOS Simulators. Ask it to tap a button, run a profiler or reproduce an issue manually - all from within your CLI, without switching context.
+**[Argent](https://argent.swmansion.com)** is an **agentic toolkit** that gives your AI assistant direct access to iOS Simulators and Android Emulators. Ask it to tap a button, run a profiler or reproduce an issue manually - all from within your CLI, without switching context.
 
 ```bash
 npx @swmansion/argent init
@@ -14,7 +14,7 @@ npx @swmansion/argent init
 
 ## Capabilities
 
-- **Autonomous iOS development** - Allow your agent to work with iOS apps on its own - let it build, open, interact with the app and debug it. Ask for reproducing issues, testing features manually, profiling your app and much more, without ever interrupting your work.
+- **Autonomous iOS and Android development** - Allow your agent to work with iOS and Android apps on its own - let it build, open, interact with the app and debug it. Ask for reproducing issues, testing features manually, profiling your app and much more, without ever interrupting your work.
 - **UI interaction** - Give your agent full control toolkit - tapping, swiping, pinching, typing, gestures, hardware buttons and all other gears included. Let it navigate your app exactly as a user would, without lifting a finger.
 - **Profiling with batteries included** - Argent can perform and analyze both React-Native and Xcode Instruments profiling sessions. Get comprehensive summaries and ask to optimise your app where you find fit.
 - **Debugging and diagnostics** - Let your agent inspect logs, capture crash reports, and reproduce failing states on the simulator, so you can jump straight to the fix.
@@ -33,8 +33,9 @@ npx @swmansion/argent init
 
 #### Prerequisites
 
-- macOS with **Xcode** installed
 - **Node.js 18** or later
+- For iOS: macOS with **Xcode** installed
+- For Android: **Android SDK Platform Tools** (`adb`) on `PATH`, and the **Android Emulator** package if you want to boot AVDs from Argent. Create AVDs via Android Studio or `avdmanager`.
 
 #### Run `init` in your project
 

package/agents/argent-environment-inspector.md

@@ -45,7 +45,7 @@ but required by the main agent, fill it in by manual inspection of the project.
    - `expo` in dependencies or `app.json` with `expo` key → Expo project
    - `pubspec.yaml` present → Flutter project
    - `ios/*.xcodeproj` or `ios/*.xcworkspace` without `react-native` → native iOS
-   - `android/build.gradle` without `react-native` → native Android
+   - `android/build.gradle` or `android/build.gradle.kts` without `react-native` → native Android
    - None of the above → classify based on what you find (web app, library, etc.)
 
 3. **Explore beyond the snapshot.** Use Read, Glob, Grep, and Bash to fill
@@ -64,7 +64,7 @@ but required by the main agent, fill it in by manual inspection of the project.
      flows (`.maestro/`).
    - For Flutter: `pubspec.yaml`, `analysis_options.yaml`, `lib/` structure.
    - For native iOS: Xcode project/workspace, schemes, `Podfile`, `Package.swift`.
-   - For native Android: `build.gradle`, `settings.gradle`, flavor configs.
+   - For native Android: `build.gradle` / `build.gradle.kts`, `settings.gradle` / `settings.gradle.kts`, flavor configs.
 
 4. **Populate every field** in the output schema below. Use `null` for
    genuinely unknown values or fields that do not apply to this project type.
@@ -89,6 +89,8 @@ Return a JSON object with these top-level fields:
 | `startup_commands`                    | array        | `[{ command, context }]` — concrete dev server start commands                                 |
 | `build_commands`                      | array        | `[{ command, platform, context }]` — build commands per platform                              |
 | `argent_workflow`                     | object       | `{ start_dev_server, build_ios, build_android, notes }` — exact commands for Argent           |
+| `ios_has_podfile`                     | bool         | True when `ios/Podfile` exists                                                                |
+| `android_has_gradle`                  | bool         | True when `android/gradlew` exists                                                            |
 | `configs`                             | object       | Paths to metro, babel, app, tsconfig, pubspec, xcode, gradle configs (`null` if absent)       |
 | `metro_port`                          | number\|null | From config or default 8081; `null` for non-RN                                                |
 | `env_resolution`                      | object       | `{ env_files, strategy, notes }`                                                              |

package/agents/references/quality-control-checklist.md

@@ -41,5 +41,5 @@ Look for these beyond the obvious lint/test configs, regardless of project type:
 - `lint-staged` config — what runs on commit
 - CI config files — the CI steps are ground truth for what "passing" means
 - `Podfile` / `Package.swift` — iOS dependency management
-- `build.gradle` / `settings.gradle` — Android build config and flavor definitions
+- `build.gradle` / `build.gradle.kts` / `settings.gradle` / `settings.gradle.kts` — Android build config and flavor definitions (Groovy or Kotlin DSL)
 - `pubspec.yaml` / `analysis_options.yaml` — Flutter project config and lint rules

package/dist/cli-cmds.mjs

@@ -459,7 +459,7 @@ Invoke a tool exposed by the argent tool-server. Run \`argent tools\` to list
 available tools, or \`argent tools describe <name>\` to see one tool's flags.
 
 Examples:
-  argent run list-simulators
+  argent run list-devices
   argent run gesture-tap --udid <UDID> --x 0.5 --y 0.5
   argent run screenshot --udid <UDID> --out ./screen.png
   argent run run-sequence --udid <UDID> --steps-json '[{"tool":"button","args":{"button":"home"}}]'

package/dist/installer.mjs

@@ -10392,7 +10392,7 @@ ${l}
 var import_picocolors2 = __toESM(require_picocolors(), 1);
 import { existsSync as existsSync3 } from "node:fs";
 import { resolve as resolve2 } from "node:path";
-import { execSync as execSync2, spawn } from "node:child_process";
+import { spawn } from "node:child_process";
 
 // ../argent-installer/src/mcp-configs.ts
 import * as fs2 from "node:fs";
@@ -12825,6 +12825,28 @@ function isNewerVersion(candidate, current) {
   if (!import_semver.default.valid(candidate) || !import_semver.default.valid(current)) return false;
   return import_semver.default.gt(candidate, current);
 }
+var TEMP_RUNNER_MARKERS = [
+  "_npx",
+  "/dlx-",
+  "\\dlx-",
+  "bun/install/cache",
+  ".bun\\install\\cache"
+];
+function isTempRunnerPath(binaryPath) {
+  return TEMP_RUNNER_MARKERS.some((marker) => binaryPath.includes(marker));
+}
+function isGloballyInstalled() {
+  try {
+    const cmd = process.platform === "win32" ? "where" : "which -a";
+    const output = execSync(`${cmd} ${MCP_BINARY_NAME}`, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    return output.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).some((line) => !isTempRunnerPath(line));
+  } catch {
+    return false;
+  }
+}
 function isSkillsCliAvailable() {
   try {
     execSync("npx --no-install skills --version", {
@@ -13700,25 +13722,6 @@ function formatSkillRefreshSummary(results) {
 }
 
 // ../argent-installer/src/init.ts
-var TEMP_RUNNER_MARKERS = [
-  "_npx",
-  "/dlx-",
-  "\\dlx-",
-  "bun/install/cache",
-  ".bun\\install\\cache"
-];
-function isGloballyInstalled() {
-  try {
-    const cmd = process.platform === "win32" ? "where" : "which";
-    const binaryPath = execSync2(`${cmd} ${MCP_BINARY_NAME}`, {
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-    return !TEMP_RUNNER_MARKERS.some((marker) => binaryPath.includes(marker));
-  } catch {
-    return false;
-  }
-}
 function runShellCommand(cmd) {
   return new Promise((resolve3, reject) => {
     const isWin = process.platform === "win32";
@@ -14246,8 +14249,9 @@ async function killToolServer() {
 async function update(args) {
   const nonInteractive = args.includes("--yes") || args.includes("-y");
   Wt2(import_picocolors3.default.bgCyan(import_picocolors3.default.black(" argent update ")));
-  const installed = getInstalledVersion();
-  if (!installed) {
+  const globallyInstalled = isGloballyInstalled();
+  const installed = globallyInstalled ? getInstalledVersion() : null;
+  if (globallyInstalled && !installed) {
     R2.error("Could not determine installed version.");
     process.exit(1);
   }
@@ -14262,21 +14266,28 @@ async function update(args) {
     process.exit(1);
   }
   spinner.stop("Version check complete.");
-  R2.info(`Installed: ${import_picocolors3.default.cyan(`v${installed}`)}`);
+  if (installed) {
+    R2.info(`Installed: ${import_picocolors3.default.cyan(`v${installed}`)}`);
+  } else {
+    R2.warn(`${PACKAGE_NAME} is not installed globally.`);
+  }
   R2.info(`Latest:    ${import_picocolors3.default.cyan(`v${latest}`)}`);
-  if (isNewerVersion(latest, installed)) {
-    R2.warn(`Update available: ${import_picocolors3.default.yellow(`v${installed}`)} -> ${import_picocolors3.default.green(`v${latest}`)}`);
+  const needsInstall = !installed || isNewerVersion(latest, installed);
+  if (needsInstall) {
+    if (installed) {
+      R2.warn(`Update available: ${import_picocolors3.default.yellow(`v${installed}`)} -> ${import_picocolors3.default.green(`v${latest}`)}`);
+    }
     const pm = detectPackageManager();
     const cmd = globalInstallCommand(pm, `${PACKAGE_NAME}@${latest}`);
     const cmdStr = formatShellCommand(cmd);
     if (!nonInteractive) {
       R2.message(import_picocolors3.default.dim("  Press y for yes, n for no, enter to confirm."));
       const proceed = await Rt({
-        message: `Update to v${latest}?`,
+        message: installed ? `Update to v${latest}?` : `Install ${PACKAGE_NAME}@${latest} globally?`,
         initialValue: true
       });
       if (Ct(proceed) || !proceed) {
-        Nt("Update cancelled.");
+        Nt(installed ? "Update cancelled." : "Install cancelled.");
         process.exit(0);
       }
     }
@@ -14288,7 +14299,7 @@ async function update(args) {
         env: { ...process.env, ARGENT_SKIP_POSTINSTALL: "1" }
       });
     } catch (err) {
-      R2.error(`Update failed: ${err}`);
+      R2.error(`${installed ? "Update" : "Install"} failed: ${err}`);
       process.exit(1);
     }
   } else {

package/dist/mcp-server.mjs

@@ -14230,7 +14230,7 @@ async function startMcpServer(options) {
     { name: "argent", version: "0.5.3" },
     {
       capabilities: { tools: {} },
-      instructions: "Argent \u2014 iOS Simulator Control for interacting, testing, profiling and debugging mobile applications. Always use discovery tools (describe / debugger-component-tree / screenshot) before tapping \u2014 never guess coordinates. On session end: call stop-all-simulator-servers and perform any necessary cleanup. Full guidance is in the argent rule loaded from .claude/rules/argent.md."
+      instructions: "Argent \u2014 iOS Simulator and Android Emulator control for interacting, testing, profiling and debugging mobile applications. Always use discovery tools (describe / debugger-component-tree / screenshot) before tapping \u2014 never guess coordinates. On session end: call stop-all-simulator-servers and perform any necessary cleanup. Full guidance is in the argent rule loaded from .claude/rules/argent.md."
     }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => {