{
  "slug": "eas-simulator-start-supports-local-egress-020783db4a21",
  "title": "eas simulator:start supports local egress",
  "tools": [
    "eas"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-10T23:24:52.000Z",
  "announced_at": "2026-09-10T23:24:52.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When an iOS simulator session needs access to a development server on the CLI machine or its network, start it with `--egress local` and repeat `--egress-allow <host:port>` for each destination. Use `localhost:<port>` or `127.0.0.1:<port>` for loopback; the egress client must stay running for the session.",
    "examples": [
      "eas simulator:start --platform ios --egress local --egress-allow <host>:<port>",
      "eas simulator:start --platform ios --egress local --egress-allow localhost:<port>",
      "eas simulator:egress [--config-type dotenv|env]"
    ],
    "gotchas": [
      "Version: v24.1.0",
      "--egress local (required): Select local egress; the client must remain running for the session.",
      "--egress-allow <host:port> (required): Exact destination on the CLI machine or its network that the simulator may access through local egress; repeat for multiple destinations. Requires `--egress local`. `localhost` or `127.0.0.1` forwards that port from the simulator host to the CLI machine.",
      "--config-type dotenv|env: For `simulator:egress`, read session credentials from `.env.eas-simulator` (`dotenv`, default) or the current shell environment (`env`).",
      "--platform ios: Select iOS as the simulator platform.",
      "Prerequisite: Keep the local egress client running for the life of the session.",
      "Prerequisite: `--egress-allow` requires `--egress local`.",
      "Prerequisite: The v24.1.0 release documents the iOS system proxy and local egress behavior.",
      "Requests exit from the CLI machine only when they honor the device host's system proxy."
    ]
  },
  "why_it_matters": "When an iOS simulator session needs to reach a development server on the CLI machine or its network, start the session with local egress and allow the server host and port.",
  "sources": [
    "https://github.com/expo/eas-cli/releases/tag/v24.1.0",
    "https://github.com/expo/eas-cli/blob/main/packages/eas-cli/README.md",
    "https://github.com/expo/eas-cli/blob/v24.1.0/packages/eas-cli/src/commands/simulator/egress.ts"
  ],
  "rank": 0.97036,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2a-20261017",
    "verdict_id": "wave2a-20261017:wave2a-20261017-454c869c7ae2469d-0:gate",
    "evidence_hash": "f91ebd72d6a5bb7729adbc26b6f83354d2d5d3e0e4111b4f7781713ce423dd7b"
  },
  "review": {
    "draft_hash": "20a848bca0347f00ac85c6776cb5136a16bf2e69ea3da8e471355e188041c0cd",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2a-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.72 (>= 0.6 needed)."
  }
}