[eas-cli] add eas simulator:start command by szdziedzic · Pull Request #3625 · expo/eas-cli

szdziedzic · 2026-04-23T13:47:15Z

Why

Part of ENG-20714

Add hidden and experimental eas simulator:start command that starts remote agent device session on EAS server and outputs exportend env vars that allow to connect with it.

How

Use createDeviceSessionRun to start the session. Wait until our job run outputs the exports in the logs and forward them to the user. This is quite hacky but good for v-1 so we can start playing with it now internally.

Test Plan

Test manually

szdziedzic · 2026-04-23T13:47:29Z

[eas-cli] add eas simulator:stop command #3626
[eas-cli] add eas simulator:start command #3625 👈 (View in Graphite)
main

This stack of pull requests is managed by Graphite. Learn more about stacking.

linear · 2026-04-23T13:50:41Z

ENG-20714 Add `eas simulator:start` and `eas simulator:stop` commands

github-actions · 2026-04-23T13:53:42Z

Subscribed to pull request

File Patterns	Mentions
*/	@douglowder
packages/eas-cli/src/build/**	@sjchmiela

Generated by CodeMention

Copilot

Pull request overview

Adds an (hidden) experimental eas simulator:start command to create a remote device run session on EAS, poll the job run logs until connection env vars appear, and present connection details to the user.

Changes:

Add GraphQL mutation/query wrappers for creating and fetching DeviceRunSession + regenerate GraphQL types/schema.
Introduce eas simulator:start command with polling + log parsing to extract exported env vars.
Add getJobRunUrl helper for linking to job runs in the Expo website UI.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
packages/eas-cli/src/graphql/queries/DeviceRunSessionQuery.ts	Adds query for fetching a device run session (including turtle job run status/log URLs).
packages/eas-cli/src/graphql/mutations/DeviceRunSessionMutation.ts	Adds mutation for creating a device run session.
packages/eas-cli/src/graphql/generated.ts	Regenerates GraphQL types to include device run session schema additions.
packages/eas-cli/src/commands/simulator/start.ts	New experimental command implementing session creation, polling, and log parsing to surface env vars.
packages/eas-cli/src/build/utils/url.ts	Adds `getJobRunUrl` for deep-linking to job run pages.
packages/eas-cli/graphql.schema.json	Updates schema introspection to include new server fields/types.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-23T13:58:01Z

+    if (!baseUrl || !authToken) {
+      pollSpinner.fail(`Timed out waiting for ${flags.type} daemon to start`);
+      throw new Error(
+        `Timed out after ${Math.round(
+          POLL_TIMEOUT_MS / 1000


On timeout/failure this command throws without attempting to stop the created device run session, which may leave a remote session running and consuming resources. Consider a best-effort cleanup (e.g. call the stopDeviceRunSession mutation in a finally/error path, or at least print the session id with guidance on how to stop it).

I will do it as follow up

codecov · 2026-04-23T13:58:23Z

Codecov Report

❌ Patch coverage is 22.76423% with 190 lines in your changes missing coverage. Please review.
✅ Project coverage is 55.48%. Comparing base (900ad76) to head (e7fc28b).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
packages/eas-cli/src/commands/simulator/start.ts	19.17%	97 Missing ⚠️
...c/steps/functions/startAgentDeviceRemoteSession.ts	16.67%	85 Missing ⚠️
.../src/graphql/mutations/DeviceRunSessionMutation.ts	50.00%	3 Missing ⚠️
...s-cli/src/graphql/queries/DeviceRunSessionQuery.ts	50.00%	3 Missing ⚠️
packages/eas-cli/src/build/utils/url.ts	33.34%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3625      +/-   ##
==========================================
- Coverage   55.70%   55.48%   -0.22%     
==========================================
  Files         852      856       +4     
  Lines       36549    36795     +246     
  Branches     7642     7645       +3     
==========================================
+ Hits        20356    20412      +56     
- Misses      14774    16288    +1514     
+ Partials     1419       95    -1324

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

sjchmiela · 2026-04-23T14:05:44Z

  ).toString();
 }

+export function getJobRunUrl(


Suggested change

export function getJobRunUrl(

export function getBareJobRunUrl(

I remember whipping up that page as a temporary measure before adding we had workflow run page. Maybe this will make it clear it's not to be used in general (especially not if workflow run is available)? Or maybe we want to mark it as deprecated?

sjchmiela · 2026-04-23T14:06:21Z

+function toTypeFlagValue(type: DeviceRunSessionType): string {
+  return type.toLowerCase().replaceAll('_', '-');
+}


Let's use a Record<DeviceRunSessionType, string> instead? Or Record<string, DeviceRunSessionType>, whatever makes sense.

sjchmiela · 2026-04-23T14:07:27Z

+export default class SimulatorStart extends EasCommand {
+  static override hidden = true;
+  static override description =
+    '[EXPERIMENTAL] start a remote simulator session on an EAS VM and get the credentials to connect to it with the CLI tool of your choice';


Suggested change

'[EXPERIMENTAL] start a remote simulator session on an EAS VM and get the credentials to connect to it with the CLI tool of your choice';

'[EXPERIMENTAL] start a remote simulator session on EAS and get the credentials to connect to it with the CLI tool of your choice';

sjchmiela · 2026-04-23T14:07:42Z

+
+  static override flags = {
+    platform: Flags.option({
+      description: 'Platform to start the simulator session for',


Suggested change

description: 'Platform to start the simulator session for',

description: 'Device platform',

?

sjchmiela · 2026-04-23T14:08:06Z

+    platform: Flags.option({
+      description: 'Platform to start the simulator session for',
+      options: ['android', 'ios'] as const,
+      default: 'ios',


Suggested change

default: 'ios',

hmmmm not sure

sjchmiela · 2026-04-23T14:11:53Z

+          jobRunStatus === JobRunStatus.Finished
+        ) {
+          throw new Error(
+            `Turtle job run for device run session ${deviceRunSessionId} is ${jobRunStatus.toLowerCase()} before the ${flags.type} daemon was ready.`


Suggested change

`Turtle job run for device run session ${deviceRunSessionId} is ${jobRunStatus.toLowerCase()} before the ${flags.type} daemon was ready.`

`Turtle job run for device run session ${deviceRunSessionId} ${jobRunStatus.toLowerCase()} before the ${flags.type} daemon was ready.`

sjchmiela · 2026-04-23T14:14:05Z

+const BASE_URL_ENV_VAR = 'AGENT_DEVICE_DAEMON_BASE_URL';
+const AUTH_TOKEN_ENV_VAR = 'AGENT_DEVICE_DAEMON_AUTH_TOKEN';


It feels like in this file we mix being ready to support multiple backends (extractor for type) and hardcoding agent-device (these consts).

Maybe it would be simpler if the extractor was returning { ready, message } and if ready we stop polling and print message? Then all agent-device, agent-simulator-specific config would be inside that one function?

sjchmiela · 2026-04-23T14:14:59Z

+): Promise<{ baseUrl?: string; authToken?: string }> {
+  let text: string;
+  try {
+    const response = await fetch(url);


until we move to the nicer way of providing these which we discussed in slack I think fetching and parsing logs is going to be common for all backends so we might want to do it before extraction

sjchmiela · 2026-04-23T14:15:33Z

+    }
+
+    Log.newLine();
+    Log.log(`🔑 Run the following in your shell to attach the ${flags.type} to the EAS VM:`);


Suggested change

Log.log(`🔑 Run the following in your shell to attach the ${flags.type} to the EAS VM:`);

Log.log(`🔑 Run the following in your shell to attach to ${flags.type}:`);

sjchmiela · 2026-04-23T14:15:59Z

+  return line;
+}
+
+function extractExportedEnvValue(text: string, varName: string): string | undefined {


i wonder if we shouldn't parse this in the eas function…

sjchmiela · 2026-04-23T15:41:40Z

+      await cloneAgentDeviceAsync({ packageVersion, env, logger });
+
+      logger.info('Installing agent-device dependencies.');
+      await spawn('npm', ['install', '--omit=dev', '--no-audit', '--no-fund'], {


Can we try using bun as package manager and runner? Might be faster?

sjchmiela · 2026-04-23T15:42:33Z

+      await fs.promises.mkdir(RUN_DIR, { recursive: true });
+
+      logger.info('Ensuring cloudflared is installed.');
+      await ensureCloudflaredInstalledAsync({ env, logger });


I guess it would be nicer to have had these as separate EAS functions (for this to be a function group) but for v-1 it's ok i guess

Will come back to it in follow up

sjchmiela · 2026-04-23T15:43:58Z

+    child.unref();
+    logger.info(`Started detached process (pid ${child.pid}).`);
+  } finally {
+    fs.closeSync(fd);


I presume closing this does not prevent the command from writing to this file?

sjchmiela · 2026-04-23T15:44:52Z

+      });
+
+      logger.info('Waiting for the daemon to report its HTTP port.');
+      const daemonPort = await waitForMatchInLogAsync({


i think port is gettable from the file too

github-actions · 2026-04-23T15:53:11Z

⏩ The changelog entry check has been skipped since the "no changelog" label is present.

szdziedzic added the no changelog PR that doesn't require a changelog entry label Apr 23, 2026 — with Graphite App

szdziedzic force-pushed the 04-23-_eas-cli_add_eas_simulator_start_command branch from ed5e0bd to b188388 Compare April 23, 2026 13:52

szdziedzic requested review from Copilot and sjchmiela April 23, 2026 13:53

szdziedzic marked this pull request as ready for review April 23, 2026 13:53

Copilot started reviewing on behalf of szdziedzic April 23, 2026 13:53 View session

Copilot AI reviewed Apr 23, 2026

View reviewed changes

szdziedzic force-pushed the 04-23-_eas-cli_add_eas_simulator_start_command branch from b188388 to e6ad3f5 Compare April 23, 2026 14:15

sjchmiela requested changes Apr 23, 2026

View reviewed changes

szdziedzic force-pushed the 04-23-_eas-cli_add_eas_simulator_start_command branch 3 times, most recently from 6e20797 to d07eb7f Compare April 23, 2026 14:58

szdziedzic mentioned this pull request Apr 23, 2026

[eas-cli] add eas simulator:stop command #3626

Open

szdziedzic requested a review from sjchmiela April 23, 2026 15:13

szdziedzic force-pushed the 04-23-_eas-cli_add_eas_simulator_start_command branch 2 times, most recently from 9a5e1dc to ebbe177 Compare April 23, 2026 15:44

sjchmiela approved these changes Apr 23, 2026

View reviewed changes

[eas-cli] add eas simulator:start command

e7fc28b

szdziedzic force-pushed the 04-23-_eas-cli_add_eas_simulator_start_command branch from ebbe177 to e7fc28b Compare April 23, 2026 15:52

szdziedzic enabled auto-merge (squash) April 23, 2026 15:54

szdziedzic merged commit bec6e67 into main Apr 23, 2026
7 checks passed

szdziedzic deleted the 04-23-_eas-cli_add_eas_simulator_start_command branch April 23, 2026 15:55

	export function getJobRunUrl(
	export function getBareJobRunUrl(

	'[EXPERIMENTAL] start a remote simulator session on an EAS VM and get the credentials to connect to it with the CLI tool of your choice';
	'[EXPERIMENTAL] start a remote simulator session on EAS and get the credentials to connect to it with the CLI tool of your choice';

	description: 'Platform to start the simulator session for',
	description: 'Device platform',

	`Turtle job run for device run session ${deviceRunSessionId} is ${jobRunStatus.toLowerCase()} before the ${flags.type} daemon was ready.`
	`Turtle job run for device run session ${deviceRunSessionId} ${jobRunStatus.toLowerCase()} before the ${flags.type} daemon was ready.`

		const BASE_URL_ENV_VAR = 'AGENT_DEVICE_DAEMON_BASE_URL';
		const AUTH_TOKEN_ENV_VAR = 'AGENT_DEVICE_DAEMON_AUTH_TOKEN';

	Log.log(`🔑 Run the following in your shell to attach the ${flags.type} to the EAS VM:`);
	Log.log(`🔑 Run the following in your shell to attach to ${flags.type}:`);

Conversation

szdziedzic commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why

How

Test Plan

Uh oh!

szdziedzic commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

linear Bot commented Apr 23, 2026

Uh oh!

github-actions Bot commented Apr 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

codecov Bot commented Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Apr 23, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

szdziedzic commented Apr 23, 2026 •

edited

Loading

szdziedzic commented Apr 23, 2026 •

edited

Loading

codecov Bot commented Apr 23, 2026 •

edited

Loading