App Management

Actions

Launch apps, manage intents, and browse URLs

Access these methods through agent.actions. Launch and manage applications on the device.

`launchApp()`

TypeScript

launchApp(packageName: string, clearExisting?: boolean): Promise<void>

Launches an app by its package name.

Parameters

Name	Type	Description
`packageName`	`string`	The app's package name (e.g., 'com.android.settings')
`clearExisting?`	`boolean`	Close the existing app before launching(default: `false`)

Returns

Promise<void>Resolves when app is launched

Examples

TypeScript

await agent.actions.launchApp("com.android.settings");

Launch with fresh data

TypeScript

await agent.actions.launchApp("com.example.app", true);

`launchIntent()`

TypeScript

launchIntent(intentName: string, packageName: string | null, data: string | null, type: string | null, extras: object | null, flags: number, component: "activity" | "service" | "broadcast", isDataLocal?: boolean): Promise<void>

Launches an Android Intent with full configuration options.

Parameters

Name	Type	Description
`intentName`	`string`	Action name (e.g., "android.intent.action.VIEW")
`packageName`	`string \| null`	Target package name
`data`	`string \| null`	Intent data URI
`type`	`string \| null`	MIME type
`extras`	`object \| null`	Extra data as key-value pairs
`flags`	`number`	Intent flags
`component`	`"activity" \| "service" \| "broadcast"`	Component type to launch
`isDataLocal?`	`boolean`	If true, data is a local file path

Returns

Promise<void>Resolves when intent is launched

Examples

Open a URL

TypeScript

await agent.actions.launchIntent(
  "android.intent.action.VIEW",
  null,
  "https://example.com",
  null, null, 0, "activity"
);

`listApps()`

TypeScript

listApps(): Promise<{[packageName: string]: string}>

Gets a list of all installed apps.

Returns

{[packageName: string]: string}Object mapping package names to app display names

Examples

TypeScript

const apps = await agent.actions.listApps();
console.log(apps["com.android.chrome"]); // "Chrome"

`browse()`

TypeScript

browse(url: string, clearExistingData?: boolean): Promise<void>

Opens a URL in the default browser.

Parameters

Name	Type	Description
`url`	`string`	URL to open
`clearExistingData?`	`boolean`	Clear browser data before opening

Returns

Promise<void>Resolves when browser is launched

Examples

TypeScript

await agent.actions.browse("https://example.com");