expo

expo/eas-cli

Fastest way to build, submit, and update iOS and Android apps

View on GitHub Website / Demo Back to listing

1.4kstars 259forks 100+contributors TypeScript

README.md

<p align="center">Ship Expo and React Native apps from your terminal: build, submit, update, deploy, and automate with EAS.</p>

<p align="center">
  <a aria-label="eas documentation" href="https://docs.expo.dev/eas/">📚 Documentation</a>
  &ensp;•&ensp;
  <a aria-label="eas cli reference" href="https://docs.expo.dev/eas/cli/">📖 CLI Reference</a>
  &ensp;•&ensp;
  <a aria-label="eas" href="https://expo.dev/services">🚀 EAS</a>
  &ensp;•&ensp;
  <a aria-label="expo blog" href="https://expo.dev/blog">📝 Blog</a>
  &ensp;•&ensp;
  <a aria-label="expo changelog" href="https://expo.dev/changelog">📰 Changelog</a>
  &ensp;•&ensp;
  <a aria-label="contribute to eas cli" href="https://github.com/expo/eas-cli/blob/main/CONTRIBUTING.md">👏 Contribute</a>
</p>

---

EAS CLI is the command-line interface for [Expo Application Services (EAS)](https://expo.dev/services): deeply integrated cloud services for Expo and React Native apps, from the team behind Expo.

It gives you a terminal-native path from source code to production: compile signed Android and iOS binaries in the cloud, submit them to the app stores, push over-the-air updates, deploy web apps and API routes, and automate the entire release process, from your machine or from CI.

## Quick start

Install the CLI, log in to your Expo account, and link your project:

```sh
npm install --global eas-cli
eas login
eas init
```

Then ship:

```sh
# Compile installable Android and iOS binaries in the cloud
eas build --platform all

# Submit the latest builds to Google Play and the App Store
eas submit --platform all

# Push an over-the-air update to your users
eas update --branch production --message "Fix checkout crash"
```

Prefer not to install globally? Every command also works with `npx eas-cli@latest`:

```sh
npx eas-cli@latest build --platform ios
```

New to EAS? Follow [Create your first build](https://docs.expo.dev/build/setup/) for a complete walkthrough.

## What you can do

- **[EAS Build](https://docs.expo.dev/build/introduction/)** (`eas build`): compile and sign Android and iOS apps with custom native code in the cloud, manage app credentials, and share internal distribution builds.
- **[EAS Submit](https://docs.expo.dev/deploy/submit-to-app-stores/)** (`eas submit`): upload your app to Google Play and App Store Connect with one command.
- **[EAS Update](https://docs.expo.dev/eas-update/introduction/)** (`eas update`): push JavaScript and asset fixes directly to users, with branches, channels, runtime versions, rollouts, and rollbacks.
- **[EAS Workflows](https://docs.expo.dev/eas/workflows/get-started/)** (`eas workflow`): automate development and release with CI/CD jobs that build, test, submit, update, and deploy your app from `.eas/workflows`.
- **[EAS Hosting](https://docs.expo.dev/eas/hosting/introduction/)** (`eas deploy`): deploy Expo Router and React Native web apps and API routes.
- **[EAS Metadata](https://docs.expo.dev/eas/metadata/)** (`eas metadata:push`): maintain your app store presence from the command line (in preview).
- **Project operations** (`eas env`, `eas credentials`, `eas device`, `eas channel`, …): manage environment variables, signing credentials, Apple devices, update channels, webhooks, and project settings.

## Version policy

EAS CLI is designed to be installed globally or run with `npx`. Installing `eas-cli` into project dependencies is strongly discouraged because it can cause dependency conflicts that are difficult to debug.

If you want to enforce the `eas-cli` version for your project, use the `"cli.version"` field in [eas.json](https://docs.expo.dev/eas/json/):

```json
{
  "cli": {
    "version": ">=21.0.0"
  },
  "build": {
    // build profiles
  },
  "submit": {
    // submit profiles
  }
}
```

## Learn more

- [EAS documentation](https://docs.expo.dev/eas/) for the full service overview.
- [EAS CLI reference](https://docs.expo.dev/eas/cli/) for command usage, flags, and arguments.
- [Expo dashboard](https://expo.dev/) to view projects, builds, submissions, updates, and workflows.
- [Expo changelog](https://expo.dev/changelog) and [blog](https://expo.dev/blog) for product updates.
- [Discord](https://chat.expo.dev) for community support.

# Commands

* [`eas account:audit [ACCOUNT_NAME]`](#eas-accountaudit-account_name)
* [`eas account:login`](#eas-accountlogin)
* [`eas account:logout`](#eas-accountlogout)
* [`eas account:usage [ACCOUNT_NAME]`](#eas-accountusage-account_name)
* [`eas account:view`](#eas-accountview)
* [`eas analytics [STATUS]`](#eas-analytics-status)
* [`eas autocomplete [SHELL]`](#eas-autocomplete-shell)
* [`eas billing:manage`](#eas-billingmanage)
* [`eas billing:subscribe [PLAN]`](#eas-billingsubscribe-plan)
* [`eas branch:create [NAME]`](#eas-branchcreate-name)
* [`eas branch:delete [NAME]`](#eas-branchdelete-name)
* [`eas branch:list`](#eas-branchlist)
* [`eas branch:rename`](#eas-branchrename)
* [`eas branch:view [NAME]`](#eas-branchview-name)
* [`eas browse [PAGE]`](#eas-browse-page)
* [`eas build`](#eas-build)
* [`eas build:cancel [BUILD_ID]`](#eas-buildcancel-build_id)
* [`eas build:configure`](#eas-buildconfigure)
* [`eas build:delete [BUILD_ID]`](#eas-builddelete-build_id)
* [`eas build:dev`](#eas-builddev)
* [`eas build:download`](#eas-builddownload)
* [`eas build:inspect`](#eas-buildinspect)
* [`eas build:list`](#eas-buildlist)
* [`eas build:resign`](#eas-buildresign)
* [`eas build:run`](#eas-buildrun)
* [`eas build:submit`](#eas-buildsubmit)
* [`eas build:version:get`](#eas-buildversionget)
* [`eas build:version:set`](#eas-buildversionset)
* [`eas build:version:sync`](#eas-buildversionsync)
* [`eas build:view [BUILD_ID]`](#eas-buildview-build_id)
* [`eas channel:create [NAME]`](#eas-channelcreate-name)
* [`eas channel:delete [NAME]`](#eas-channeldelete-name)
* [`eas channel:edit [NAME]`](#eas-channeledit-name)
* [`eas channel:insights`](#eas-channelinsights)
* [`eas channel:list`](#eas-channellist)
* [`eas channel:pause [NAME]`](#eas-channelpause-name)
* [`eas channel:protect [NAME]`](#eas-channelprotect-name)
* [`eas channel:resume [NAME]`](#eas-channelresume-name)
* [`eas channel:rollout [CHANNEL]`](#eas-channelrollout-channel)
* [`eas channel:unprotect [NAME]`](#eas-channelunprotect-name)
* [`eas channel:view [NAME]`](#eas-channelview-name)
* [`eas config`](#eas-config)
* [`eas credentials`](#eas-credentials)
* [`eas credentials:configure-build`](#eas-credentialsconfigure-build)
* [`eas deploy [options]`](#eas-deploy-options)
* [`eas deploy:alias`](#eas-deployalias)
* [`eas deploy:alias:delete [ALIAS_NAME]`](#eas-deployaliasdelete-alias_name)
* [`eas deploy:delete [DEPLOYMENT_ID]`](#eas-deploydelete-deployment_id)
* [`eas deploy:promote`](#eas-deploypromote)
* [`eas device:create`](#eas-devicecreate)
* [`eas device:delete`](#eas-devicedelete)
* [`eas device:list`](#eas-devicelist)
* [`eas device:rename`](#eas-devicerename)
* [`eas device:view [UDID]`](#eas-deviceview-udid)
* [`eas diagnostics`](#eas-diagnostics)
* [`eas env:delete [ENVIRONMENT]`](#eas-envdelete-environment)
* [`eas env:exec ENVIRONMENT BASH_COMMAND`](#eas-envexec-environment-bash_command)
* [`eas env:get [ENVIRONMENT]`](#eas-envget-environment)
* [`eas env:list [ENVIRONMENT]`](#eas-envlist-environment)
* [`eas env:pull [ENVIRONMENT]`](#eas-envpull-environment)
* [`eas env:push [ENVIRONMENT]`](#eas-envpush-environment)
* [`eas env:set [ENVIRONMENT]`](#eas-envset-environment)
* [`eas fingerprint:compare [HASH1] [HASH2]`](#eas-fingerprintcompare-hash1-hash2)
* [`eas fingerprint:generate`](#eas-fingerprintgenerate)
* [`eas help [COMMAND]`](#eas-help-command)
* [`eas init`](#eas-init)
* [`eas integrations:asc:connect`](#eas-integrationsascconnect)
* [`eas integrations:asc:disconnect`](#eas-integrationsascdisconnect)
* [`eas integrations:asc:status`](#eas-integrationsascstatus)
* [`eas integrations:convex:connect`](#eas-integrationsconvexconnect)
* [`eas integrations:convex:dashboard`](#eas-integrationsconvexdashboard)
* [`eas integrations:convex:project`](#eas-integrationsconvexproject)
* [`eas integrations:convex:project:delete`](#eas-integrationsconvexprojectdelete)
* [`eas integrations:convex:team`](#eas-integrationsconvexteam)
* [`eas integrations:convex:team:delete [CONVEX_TEAM]`](#eas-integrationsconvexteamdelete-convex_team)
* [`eas integrations:convex:team:invite [CONVEX_TEAM]`](#eas-integrationsconvexteaminvite-convex_team)
* [`eas integrations:posthog:connect`](#eas-integrationsposthogconnect)
* [`eas integrations:posthog:dashboard`](#eas-integrationsposthogdashboard)
* [`eas integrations:posthog:disconnect`](#eas-integrationsposthogdisconnect)
* [`eas integrations:supabase:advisors`](#eas-integrationssupabaseadvisors)
* [`eas integrations:supabase:connect`](#eas-integrationssupabaseconnect)
* [`eas integrations:supabase:dashboard`](#eas-integrationssupabasedashboard)
* [`eas integrations:supabase:disconnect`](#eas-integrationssupabasedisconnect)
* [`eas login`](#eas-login)
* [`eas logout`](#eas-logout)
* [`eas metadata:lint`](#eas-metadatalint)
* [`eas metadata:pull`](#eas-metadatapull)
* [`eas metadata:push`](#eas-metadatapush)
* [`eas new [PATH]`](#eas-new-path)
* [`eas observe:errors`](#eas-observeerrors)
* [`eas observe:event ID`](#eas-observeevent-id)
* [`eas observe:events [EVENTNAME]`](#eas-observeevents-eventname)
* [`eas observe:metrics [METRIC]`](#eas-observemetrics-metric)
* [`eas observe:metrics-summary`](#eas-observemetrics-summary)
* [`eas observe:routes`](#eas-observeroutes)
* [`eas observe:session [SESSIONID]`](#eas-observesession-sessionid)
* [`eas observe:trace TRACEID`](#eas-observetrace-traceid)
* [`eas observe:traces`](#eas-observetraces)
* [`eas observe:versions`](#eas-observeversions)
* [`eas project:delete [NAME]`](#eas-projectdelete-name)
* [`eas project:icon:set PATH`](#eas-projecticonset-path)
* [`eas project:info`](#eas-projectinfo)
* [`eas project:init`](#eas-projectinit)
* [`eas project:new [PATH]`](#eas-projectnew-path)
* [`eas project:status`](#eas-projectstatus)
* [`eas sim:availability`](#eas-simavailability)
* [`eas sim:control [ACTION]`](#eas-simcontrol-action)
* [`eas sim:egress`](#eas-simegress)
* [`eas sim:events`](#eas-simevents)
* [`eas sim:exec`](#eas-simexec)
* [`eas sim:get`](#eas-simget)
* [`eas sim:list`](#eas-simlist)
* [`eas sim:logs`](#eas-simlogs)
* [`eas sim:start`](#eas-simstart)
* [`eas sim:stop`](#eas-simstop)
* [`eas simulator`](#eas-simulator)
* [`eas simulator:availability`](#eas-simulatoravailability)
* [`eas simulator:control [ACTION]`](#eas-simulatorcontrol-action)
* [`eas simulator:egress`](#eas-simulatoregress)
* [`eas simulator:events`](#eas-simulatorevents)
* [`eas simulator:exec`](#eas-simulatorexec)
* [`eas simulator:get`](#eas-simulatorget)
* [`eas simulator:list`](#eas-simulatorlist)
* [`eas simulator:logs`](#eas-simulatorlogs)
* [`eas simulator:start`](#eas-simulatorstart)
* [`eas simulator:stop`](#eas-simulatorstop)
* [`eas status`](#eas-status)
* [`eas submit`](#eas-submit)
* [`eas submit:cancel [SUBMISSION_ID]`](#eas-submitcancel-submission_id)
* [`eas submit:list`](#eas-submitlist)
* [`eas submit:retry [SUBMISSION_ID]`](#eas-submitretry-submission_id)
* [`eas submit:status`](#eas-submitstatus)
* [`eas submit:view [SUBMISSION_ID]`](#eas-submitview-submission_id)
* [`eas testflight:crashes [ID]`](#eas-testflightcrashes-id)
* [`eas testflight:feedback [ID]`](#eas-testflightfeedback-id)
* [`eas update`](#eas-update)
* [`eas update:configure`](#eas-updateconfigure)
* [`eas update:delete GROUPID`](#eas-updatedelete-groupid)
* [`eas update:edit [GROUPID]`](#eas-updateedit-groupid)
* [`eas update:embedded:delete ID`](#eas-updateembeddeddelete-id)
* [`eas update:embedded:list`](#eas-updateembeddedlist)
* [`eas update:embedded:upload`](#eas-updateembeddedupload)
* [`eas update:embedded:view ID`](#eas-updateembeddedview-id)
* [`eas update:insights GROUPID`](#eas-updateinsights-groupid)
* [`eas update:list`](#eas-updatelist)
* [`eas update:republish`](#eas-updaterepublish)
* [`eas update:revert-update-rollout`](#eas-updaterevert-update-rollout)
* [`eas update:roll-back-to-embedded`](#eas-updateroll-back-to-embedded)
* [`eas update:rollback [GROUPID]`](#eas-updaterollback-groupid)
* [`eas update:view GROUPID`](#eas-updateview-groupid)
* [`eas upload`](#eas-upload)
* [`eas webhook:create`](#eas-webhookcreate)
* [`eas webhook:delete [ID]`](#eas-webhookdelete-id)
* [`eas webhook:list`](#eas-webhooklist)
* [`eas webhook:update`](#eas-webhookupdate)
* [`eas webhook:view ID`](#eas-webhookview-id)
* [`eas whoami`](#eas-whoami)
* [`eas worker:alias`](#eas-workeralias)
* [`eas worker:alias:delete [ALIAS_NAME]`](#eas-workeraliasdelete-alias_name)
* [`eas worker:delete [DEPLOYMENT_ID]`](#eas-workerdelete-deployment_id)
* [`eas deploy [options]`](#eas-deploy-options)
* [`eas workflow:cancel`](#eas-workflowcancel)
* [`eas workflow:create [NAME]`](#eas-workflowcreate-name)
* [`eas workflow:insights`](#eas-workflowinsights)
* [`eas workflow:insights:maestro`](#eas-workflowinsightsmaestro)
* [`eas workflow:logs [ID]`](#eas-workflowlogs-id)
* [`eas workflow:run FILE`](#eas-workflowrun-file)
* [`eas workflow:runs`](#eas-workflowruns)
* [`eas workflow:status [WORKFLOW_RUN_ID]`](#eas-workflowstatus-workflow_run_id)
* [`eas workflow:validate PATH`](#eas-workflowvalidate-path)
* [`eas workflow:view [ID]`](#eas-workflowview-id)

## `eas account:audit [ACCOUNT_NAME]`

view the audit logs for an account

```
USAGE
  $ eas account:audit [ACCOUNT_NAME] [--limit <value>] [--after <value>] [--json] [--non-interactive]

ARGUMENTS
  [ACCOUNT_NAME]  Account name to view audit logs for. If not provided, the account will be selected interactively (or
                  defaults to the only account if there is just one)

DESCRIPTION
  view the audit logs for an account
```

_See code: [packages/eas-cli/src/commands/account/audit.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/account/audit.ts)_

## `eas account:login`

```
USAGE
  $ eas account:login [--non-interactive] [--match <value>  [--resume <value> [--device | -s]]] [-b]

FLAGS
  -b, --[no-]browser     Log in with your browser (default; use --no-browser for CLI-based login)
  -s, --sso              Log in with SSO
      --device           Log in using a code in a browser on any device
      --match=<value>    Submit the number the user sees in their browser
      --non-interactive  Run the command in non-interactive mode.
      --resume=<value>   Resume a saved device login using its request ID (one command at a time)

DESCRIPTION
  log in with your Expo account

ALIASES
  $ eas login

EXAMPLES
  $ eas login --device

$ eas login --device --non-interactive

$ eas login --device --non-interactive --resume REQUEST_ID --match NUMBER_FROM_USER
```

_See code: [packages/eas-cli/src/commands/account/login.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/account/login.ts)_

## `eas account:logout`

log out

```
USAGE
  $ eas account:logout

DESCRIPTION
  log out

ALIASES
  $ eas logout
```

_See code: [packages/eas-cli/src/commands/account/logout.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/account/logout.ts)_

## `eas account:usage [ACCOUNT_NAME]`

view account usage and billing for the current cycle

```
USAGE
  $ eas account:usage [ACCOUNT_NAME] [--json] [--non-interactive]

ARGUMENTS
  [ACCOUNT_NAME]  Account name to view usage for. If not provided, the account will be selected interactively (or
                  defaults to the only account if there is just one)

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  view account usage and billing for the current cycle
```

_See code: [packages/eas-cli/src/commands/account/usage.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/account/usage.ts)_

## `eas account:view`

show the username you are logged in as

```
USAGE
  $ eas account:view

DESCRIPTION
  show the username you are logged in as

ALIASES
  $ eas whoami
```

_See code: [packages/eas-cli/src/commands/account/view.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/account/view.ts)_

## `eas analytics [STATUS]`

display or change analytics settings (disabling analytics also disables experiments)

```
USAGE
  $ eas analytics [STATUS]

DESCRIPTION
  display or change analytics settings (disabling analytics also disables experiments)
```

_See code: [packages/eas-cli/src/commands/analytics.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/analytics.ts)_

## `eas autocomplete [SHELL]`

Display autocomplete installation instructions.

```
USAGE
  $ eas autocomplete [SHELL] [-r]

ARGUMENTS
  [SHELL]  (zsh|bash|powershell) Shell type

FLAGS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

DESCRIPTION
  Display autocomplete installation instructions.

EXAMPLES
  $ eas autocomplete

$ eas autocomplete bash

$ eas autocomplete zsh

$ eas autocomplete powershell

$ eas autocomplete --refresh-cache
```

_See code: [@oclif/plugin-autocomplete](https://github.com/oclif/plugin-autocomplete/blob/v3.2.40/src/commands/autocomplete/index.ts)_

## `eas billing:manage`

manage billing for an account with an active paid EAS plan

```
USAGE
  $ eas billing:manage [-a <value>] [--no-open] [--json] [--non-interactive]

FLAGS
  -a, --account=<value>  Account with an active paid plan to manage. Defaults to your account when only one is eligible.
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --no-open          Only print the customer portal URL instead of opening it in a browser
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  manage billing for an account with an active paid EAS plan
```

_See code: [packages/eas-cli/src/commands/billing/manage.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/billing/manage.ts)_

## `eas billing:subscribe [PLAN]`

subscribe a Free account to an EAS plan

```
USAGE
  $ eas billing:subscribe [PLAN] [-a <value>] [--no-open] [--json] [--non-interactive]

ARGUMENTS
  [PLAN]  (starter|production) plan to subscribe to. Required in non-interactive mode.

FLAGS
  -a, --account=<value>  Account to subscribe. Defaults to your account when you only have one.
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --no-open          Only print the checkout page URL instead of opening it in a browser
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  subscribe a Free account to an EAS plan
```

_See code: [packages/eas-cli/src/commands/billing/subscribe.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/billing/subscribe.ts)_

## `eas branch:create [NAME]`

create a branch

```
USAGE
  $ eas branch:create [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the branch to create

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  create a branch
```

_See code: [packages/eas-cli/src/commands/branch/create.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/branch/create.ts)_

## `eas branch:delete [NAME]`

delete a branch

```
USAGE
  $ eas branch:delete [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the branch to delete

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  delete a branch
```

_See code: [packages/eas-cli/src/commands/branch/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/branch/delete.ts)_

## `eas branch:list`

list all branches

```
USAGE
  $ eas branch:list [--offset <value>] [--limit <value>] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>    The number of items to fetch each query. Defaults to 50 and is capped at 100.
  --non-interactive  Run the command in non-interactive mode.
  --offset=<value>   Start queries from specified index. Use for paginating results. Defaults to 0.

DESCRIPTION
  list all branches
```

_See code: [packages/eas-cli/src/commands/branch/list.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/branch/list.ts)_

## `eas branch:rename`

rename a branch

```
USAGE
  $ eas branch:rename [--from <value>] [--to <value>] [--json] [--non-interactive]

FLAGS
  --from=<value>     current name of the branch.
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.
  --to=<value>       new name of the branch.

DESCRIPTION
  rename a branch
```

_See code: [packages/eas-cli/src/commands/branch/rename.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/branch/rename.ts)_

## `eas branch:view [NAME]`

view a branch

```
USAGE
  $ eas branch:view [NAME] [--offset <value>] [--limit <value>] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the branch to view

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>    The number of items to fetch each query. Defaults to 25 and is capped at 50.
  --non-interactive  Run the command in non-interactive mode.
  --offset=<value>   Start queries from specified index. Use for paginating results. Defaults to 0.

DESCRIPTION
  view a branch
```

_See code: [packages/eas-cli/src/commands/branch/view.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/branch/view.ts)_

## `eas browse [PAGE]`

transition from the terminal to the web browser to view and interact with your project on https://expo.dev

```
USAGE
  $ eas browse [PAGE] [-n] [--json] [--non-interactive]

FLAGS
  -n, --no-browser       Print the URL instead of opening it in a web browser
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  transition from the terminal to the web browser to view and interact with your project on https://expo.dev
```

_See code: [packages/eas-cli/src/commands/browse.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/browse.ts)_

## `eas build`

start a build

```
USAGE
  $ eas build [-p android|ios|all] [-e PROFILE_NAME] [--local] [--output <value>] [--wait] [--clear-cache]
    [-s | --auto-submit-with-profile PROFILE_NAME] [--what-to-test <value>] [-m <value>] [--build-logger-level
    trace|debug|info|warn|error|fatal] [--freeze-credentials] [--refresh-ad-hoc-provisioning-profile] [--verbose-logs]
    [--json] [--non-interactive]

FLAGS
  -e, --profile=PROFILE_NAME                   Name of the build profile from eas.json. Defaults to "production" if
                                               defined in eas.json.
  -m, --message=<value>                        A short message describing the build
  -p, --platform=<option>                      <options: android|ios|all>
  -s, --auto-submit                            Submit on build complete using the submit profile with the same name as
                                               the build profile
      --auto-submit-with-profile=PROFILE_NAME  Submit on build complete using the submit profile with provided name
      --build-logger-level=<option>            The level of logs to output during the build process. Defaults to "info".
                                               <options: trace|debug|info|warn|error|fatal>
      --clear-cache                            Clear cache before the build
      --freeze-credentials                     Prevent the build from updating credentials in non-interactive mode
      --json                                   Enable JSON output, non-JSON messages will be printed to stderr. Implies
                                               --non-interactive.
      --local                                  Run build locally [experimental]
      --non-interactive                        Run the command in non-interactive mode.
      --output=<value>                         Output path for local build
      --refresh-ad-hoc-provisioning-profile    Refresh managed ad-hoc provisioning profiles from App Store Connect
                                               before gathering build credentials
      --verbose-logs                           Use verbose logs for the build process
      --[no-]wait                              Wait for build(s) to complete
      --what-to-test=<value>                   Specify the "What to Test" information for the build in TestFlight
                                               (iOS-only). To be used with the `auto-submit` flag

DESCRIPTION
  start a build
```

_See code: [packages/eas-cli/src/commands/build/index.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/index.ts)_

## `eas build:cancel [BUILD_ID]`

cancel a build

```
USAGE
  $ eas build:cancel [BUILD_ID] [--non-interactive] [-p android|ios|all] [-e PROFILE_NAME]

FLAGS
  -e, --profile=PROFILE_NAME  Filter builds by build profile if build ID is not provided
  -p, --platform=<option>     Filter builds by the platform if build ID is not provided
                              <options: android|ios|all>
      --non-interactive       Run the command in non-interactive mode.

DESCRIPTION
  cancel a build
```

_See code: [packages/eas-cli/src/commands/build/cancel.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/cancel.ts)_

## `eas build:configure`

configure the project to support EAS Build

```
USAGE
  $ eas build:configure [-p android|ios|all]

FLAGS
  -p, --platform=<option>  Platform to configure
                           <options: android|ios|all>

DESCRIPTION
  configure the project to support EAS Build
```

_See code: [packages/eas-cli/src/commands/build/configure.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/configure.ts)_

## `eas build:delete [BUILD_ID]`

delete a build

```
USAGE
  $ eas build:delete [BUILD_ID] [--non-interactive] [-p android|ios|all] [-e PROFILE_NAME]

DESCRIPTION
  delete a build
```

_See code: [packages/eas-cli/src/commands/build/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/delete.ts)_

## `eas build:dev`

run dev client simulator/emulator build with matching fingerprint or create a new one

```
USAGE
  $ eas build:dev [-p ios|android] [-e PROFILE_NAME] [--skip-build-if-not-found] [--skip-bundler] [--simulator
    <value>]

FLAGS
  -e, --profile=PROFILE_NAME     Name of the build profile from eas.json. It must be a profile allowing to create
                                 emulator/simulator internal distribution dev client builds. The "development-simulator"
                                 build profile will be selected by default.
  -p, --platform=<option>        <options: ios|android>
      --simulator=<value>        iOS simulator name or UDID to install and run the development build on. If no value is
                                 provided, you will be prompted to select a simulator.
      --skip-build-if-not-found  Skip build if no successful build with matching fingerprint is found.
      --skip-bundler             Install and run the development build without starting the bundler server.

DESCRIPTION
  run dev client simulator/emulator build with matching fingerprint or create a new one
```

_See code: [packages/eas-cli/src/commands/build/dev.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/dev.ts)_

## `eas build:download`

download a simulator/emulator build by build ID or fingerprint hash

```
USAGE
  $ eas build:download [--build-id <value> | --fingerprint <value> | -p ios|android | --dev-client]
    [--all-artifacts] [--json] [--non-interactive]

FLAGS
  -p, --platform=<option>    <options: ios|android>
      --all-artifacts        Download all available build artifacts (build artifacts archive, Xcode logs, etc.) in
                             addition to the application archive. Without this flag, only the application archive is
                             downloaded and the command errors if it is missing.
      --build-id=<value>     ID of the build to download. Mutually exclusive with --fingerprint, --platform, and
                             --dev-client; the platform is derived from the build itself.
      --[no-]dev-client      Filter only dev-client builds.
      --fingerprint=<value>  Fingerprint hash of the build to download
      --json                 Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --non-interactive      Run the command in non-interactive mode.

DESCRIPTION
  download a simulator/emulator build by build ID or fingerprint hash
```

_See code: [packages/eas-cli/src/commands/build/download.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/download.ts)_

## `eas build:inspect`

inspect the state of the project at specific build stages, useful for troubleshooting

```
USAGE
  $ eas build:inspect -p android|ios -s archive|pre-build|post-build -o OUTPUT_DIRECTORY [-e PROFILE_NAME]
    [--force] [-v]

FLAGS
  -e, --profile=PROFILE_NAME
      Name of the build profile from eas.json. Defaults to "production" if defined in eas.json.

-o, --output=OUTPUT_DIRECTORY
      (required) Output directory.

-p, --platform=<option>
      (required)
      <options: android|ios>

-s, --stage=<option>
      (required) Stage of the build you want to inspect.
      archive - builds the project archive that would be uploaded to EAS when building
      pre-build - prepares the project to be built with Gradle/Xcode. Does not run the native build.
      post-build - builds the native project and leaves the output directory for inspection
      <options: archive|pre-build|post-build>

-v, --verbose

--force
      Delete OUTPUT_DIRECTORY if it already exists.

DESCRIPTION
  inspect the state of the project at specific build stages, useful for troubleshooting
```

_See code: [packages/eas-cli/src/commands/build/inspect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/inspect.ts)_

## `eas build:list`

list all builds for your project

```
USAGE
  $ eas build:list [-p android|ios|all] [--status
    new|in-queue|in-progress|pending-cancel|errored|finished|canceled] [--distribution store|internal|simulator]
    [--channel <value>] [--app-version <value>] [--app-build-version <value>] [--sdk-version <value>] [--runtime-version
    <value>] [--app-identifier <value>] [-e <value>] [--git-commit-hash <value>] [--fingerprint-hash <value>] [--offset
    <value>] [--limit <value>] [--json] [--non-interactive] [--simulator]

FLAGS
  -e, --build-profile=<value>      Filter only builds created with the specified build profile
  -p, --platform=<option>          <options: android|ios|all>
      --app-build-version=<value>  Filter only builds created with the specified app build version
      --app-identifier=<value>     Filter only builds created with the specified app identifier
      --app-version=<value>        Filter only builds created with the specified main app version
  --channel=<value>
      --distribution=<option>      Filter only builds with the specified distribution type
                                   <options: store|internal|simulator>
      --fingerprint-hash=<value>   Filter only builds with the specified fingerprint hash
      --git-commit-hash=<value>    Filter only builds created with the specified git commit hash
      --json                       Enable JSON output, non-JSON messages will be printed to stderr. Implies
                                   --non-interactive.
      --limit=<value>              The number of items to fetch each query. Defaults to 10 and is capped at 50.
      --non-interactive            Run the command in non-interactive mode.
      --offset=<value>             Start queries from specified index. Use for paginating results. Defaults to 0.
      --runtime-version=<value>    Filter only builds created with the specified runtime version
      --sdk-version=<value>        Filter only builds created with the specified Expo SDK version
      --simulator                  Filter only iOS simulator builds. Can only be used with --platform flag set to "ios"
      --status=<option>            Filter only builds with the specified status
                                   <options: new|in-queue|in-progress|pending-cancel|errored|finished|canceled>

DESCRIPTION
  list all builds for your project
```

_See code: [packages/eas-cli/src/commands/build/list.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/list.ts)_

## `eas build:resign`

re-sign a build archive

```
USAGE
  $ eas build:resign [-p android|ios] [-e PROFILE_NAME] [--source-profile PROFILE_NAME] [--wait] [--id <value>]
    [--offset <value>] [--limit <value>] [--json] [--non-interactive]

FLAGS
  -e, --target-profile=PROFILE_NAME  Name of the target build profile from eas.json. Credentials and environment
                                     variables from this profile will be used when re-signing. Defaults to "production"
                                     if defined in eas.json.
  -p, --platform=<option>            <options: android|ios>
      --id=<value>                   ID of the build to re-sign.
      --json                         Enable JSON output, non-JSON messages will be printed to stderr. Implies
                                     --non-interactive.
      --limit=<value>                The number of items to fetch each query. Defaults to 50 and is capped at 100.
      --non-interactive              Run the command in non-interactive mode.
      --offset=<value>               Start queries from specified index. Use for paginating results. Defaults to 0.
      --source-profile=PROFILE_NAME  Name of the source build profile from eas.json. Used to filter builds eligible for
                                     re-signing.
      --[no-]wait                    Wait for build(s) to complete.

DESCRIPTION
  re-sign a build archive
```

_See code: [packages/eas-cli/src/commands/build/resign.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/resign.ts)_

## `eas build:run`

run simulator/emulator builds from eas-cli

```
USAGE
  $ eas build:run [--latest | --id <value> | --path <value> | --url <value>] [-p android|ios] [-e PROFILE_NAME]
    [--simulator <value>] [--offset <value>] [--limit <value>]

FLAGS
  -e, --profile=PROFILE_NAME  Name of the build profile used to create the build to run. When specified, only builds
                              created with the specified build profile will be queried.
  -p, --platform=<option>     <options: android|ios>
      --id=<value>            ID of the simulator/emulator build to run
      --latest                Run the latest simulator/emulator build for specified platform
      --limit=<value>         The number of items to fetch each query. Defaults to 50 and is capped at 100.
      --offset=<value>        Start queries from specified index. Use for paginating results. Defaults to 0.
      --path=<value>          Path to the simulator/emulator build archive or app
      --simulator=<value>     iOS simulator name or UDID to install and run the build on. If no value is provided, you
                              will be prompted to select a simulator.
      --url=<value>           Simulator/Emulator build archive url

DESCRIPTION
  run simulator/emulator builds from eas-cli
```

_See code: [packages/eas-cli/src/commands/build/run.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/run.ts)_

## `eas build:submit`

submit app binary to App Store and/or Play Store

```
USAGE
  $ eas build:submit [-p android|ios|all] [-e <value>] [--latest | --id <value> | --path <value> | --url <value>]
    [--what-to-test <value>] [--verbose] [--wait] [--verbose-fastlane] [-g <value>...] [--non-interactive]
    [--auto-testflight-setup]

FLAGS
  -e, --profile=<value>             Name of the submit profile from eas.json. Defaults to "production" if defined in
                                    eas.json.
  -g, --groups=<value>...           Internal TestFlight testing groups to add the build to (iOS only). Learn more:
                                    https://developer.apple.com/help/app-store-connect/test-a-beta-version/add-internal-
                                    testers
  -p, --platform=<option>           <options: android|ios|all>
      --[no-]auto-testflight-setup  Set up an internal TestFlight group for the app (iOS only)
      --id=<value>                  ID of the build to submit
      --latest                      Submit the latest build for specified platform
      --non-interactive             Run command in non-interactive mode
      --path=<value>                Path to the .apk/.aab/.ipa file
      --url=<value>                 App archive url
      --verbose                     Always print logs from EAS Submit
      --verbose-fastlane            Enable verbose logging for the submission process
      --[no-]wait                   Wait for submission to complete
      --what-to-test=<value>        Sets the "What to test" information in TestFlight (iOS only).

DESCRIPTION
  submit app binary to App Store and/or Play Store

ALIASES
  $ eas build:submit
```

## `eas build:version:get`

get the latest version from EAS servers

```
USAGE
  $ eas build:version:get [-p android|ios|all] [-e PROFILE_NAME] [--json] [--non-interactive]

FLAGS
  -e, --profile=PROFILE_NAME  Name of the build profile from eas.json. Defaults to "production" if defined in eas.json.
  -p, --platform=<option>     <options: android|ios|all>
      --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies
                              --non-interactive.
      --non-interactive       Run the command in non-interactive mode.

DESCRIPTION
  get the latest version from EAS servers
```

_See code: [packages/eas-cli/src/commands/build/version/get.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/version/get.ts)_

## `eas build:version:set`

update version of an app

```
USAGE
  $ eas build:version:set [-p android|ios] [-e PROFILE_NAME]

FLAGS
  -e, --profile=PROFILE_NAME  Name of the build profile from eas.json. Defaults to "production" if defined in eas.json.
  -p, --platform=<option>     <options: android|ios>

DESCRIPTION
  update version of an app
```

_See code: [packages/eas-cli/src/commands/build/version/set.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/version/set.ts)_

## `eas build:version:sync`

update a version in native code with a value stored on EAS servers

```
USAGE
  $ eas build:version:sync [-p android|ios|all] [-e PROFILE_NAME]

FLAGS
  -e, --profile=PROFILE_NAME  Name of the build profile from eas.json. Defaults to "production" if defined in eas.json.
  -p, --platform=<option>     <options: android|ios|all>

DESCRIPTION
  update a version in native code with a value stored on EAS servers
```

_See code: [packages/eas-cli/src/commands/build/version/sync.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/version/sync.ts)_

## `eas build:view [BUILD_ID]`

view a build for your project

```
USAGE
  $ eas build:view [BUILD_ID] [--json]

FLAGS
  --json  Enable JSON output, non-JSON messages will be printed to stderr.

DESCRIPTION
  view a build for your project
```

_See code: [packages/eas-cli/src/commands/build/view.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/build/view.ts)_

## `eas channel:create [NAME]`

create a channel

```
USAGE
  $ eas channel:create [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to create

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  create a channel
```

_See code: [packages/eas-cli/src/commands/channel/create.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/create.ts)_

## `eas channel:delete [NAME]`

delete a channel

```
USAGE
  $ eas channel:delete [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to delete

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  delete a channel
```

_See code: [packages/eas-cli/src/commands/channel/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/delete.ts)_

## `eas channel:edit [NAME]`

point a channel at a new branch

```
USAGE
  $ eas channel:edit [NAME] [--branch <value>] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to edit

FLAGS
  --branch=<value>   Name of the branch to point to
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  point a channel at a new branch
```

_See code: [packages/eas-cli/src/commands/channel/edit.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/edit.ts)_

## `eas channel:insights`

display adoption, crash, and unique-user insights for a channel + runtime version

```
USAGE
  $ eas channel:insights --channel <value> --runtime-version <value> [--days <value> | --start <value> | --end
    <value>] [--json] [--non-interactive]

FLAGS
  --channel=<value>          (required) Name of the channel.
  --days=<value>             Show insights from the last N days (default 7, mutually exclusive with --start/--end).
  --end=<value>              End of insights time range (ISO date).
  --json                     Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive          Run the command in non-interactive mode.
  --runtime-version=<value>  (required) Runtime version to query insights for.
  --start=<value>            Start of insights time range (ISO date).

DESCRIPTION
  display adoption, crash, and unique-user insights for a channel + runtime version
```

_See code: [packages/eas-cli/src/commands/channel/insights.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/insights.ts)_

## `eas channel:list`

list all channels

```
USAGE
  $ eas channel:list [--offset <value>] [--limit <value>] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>    The number of items to fetch each query. Defaults to 10 and is capped at 25.
  --non-interactive  Run the command in non-interactive mode.
  --offset=<value>   Start queries from specified index. Use for paginating results. Defaults to 0.

DESCRIPTION
  list all channels
```

_See code: [packages/eas-cli/src/commands/channel/list.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/list.ts)_

## `eas channel:pause [NAME]`

pause a channel to stop it from sending updates

```
USAGE
  $ eas channel:pause [NAME] [--branch <value>] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to edit

DESCRIPTION
  pause a channel to stop it from sending updates
```

_See code: [packages/eas-cli/src/commands/channel/pause.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/pause.ts)_

## `eas channel:protect [NAME]`

protect a channel so only Release Managers, Admins, and Owners can publish to it

```
USAGE
  $ eas channel:protect [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to protect

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  protect a channel so only Release Managers, Admins, and Owners can publish to it
```

_See code: [packages/eas-cli/src/commands/channel/protect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/protect.ts)_

## `eas channel:resume [NAME]`

resume a channel to start sending updates

```
USAGE
  $ eas channel:resume [NAME] [--branch <value>] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to edit

DESCRIPTION
  resume a channel to start sending updates
```

_See code: [packages/eas-cli/src/commands/channel/resume.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/resume.ts)_

## `eas channel:rollout [CHANNEL]`

roll a new branch out on a channel incrementally

```
USAGE
  $ eas channel:rollout [CHANNEL] [--action create|edit|end|view] [--percent <value>] [--outcome
    republish-and-revert|revert] [--branch <value>] [--runtime-version <value>] [--private-key-path <value>] [--json]
    [--non-interactive]

ARGUMENTS
  [CHANNEL]  channel on which the rollout should be done

FLAGS
  --action=<option>           Rollout action to perform
                              <options: create|edit|end|view>
  --branch=<value>            Branch to roll out. Use with --action=create
  --json                      Enable JSON output, non-JSON messages will be printed to stderr. Implies
                              --non-interactive.
  --non-interactive           Run the command in non-interactive mode.
  --outcome=<option>          End outcome of rollout. Use with --action=end
                              <options: republish-and-revert|revert>
  --percent=<value>           Percent of users to send to the new branch. Use with --action=edit or --action=create
  --private-key-path=<value>  File containing the PEM-encoded private key corresponding to the certificate in
                              expo-updates' configuration. Defaults to a file named "private-key.pem" in the
                              certificate's directory. Only relevant if you are using code signing:
                              https://docs.expo.dev/eas-update/code-signing/
  --runtime-version=<value>   Runtime version to target. Use with --action=create

DESCRIPTION
  roll a new branch out on a channel incrementally
```

_See code: [packages/eas-cli/src/commands/channel/rollout.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/rollout.ts)_

## `eas channel:unprotect [NAME]`

remove a channel's protected publishing restriction

```
USAGE
  $ eas channel:unprotect [NAME] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Name of the channel to unprotect

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  remove a channel's protected publishing restriction
```

_See code: [packages/eas-cli/src/commands/channel/unprotect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/unprotect.ts)_

## `eas channel:view [NAME]`

view a channel

```
USAGE
  $ eas channel:view [NAME] [--json] [--non-interactive] [--offset <value>] [--limit <value>]

ARGUMENTS
  [NAME]  Name of the channel to view

DESCRIPTION
  view a channel
```

_See code: [packages/eas-cli/src/commands/channel/view.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/channel/view.ts)_

## `eas config`

display project configuration (app.json + eas.json)

```
USAGE
  $ eas config [-p android|ios] [-e PROFILE_NAME] [--json] [--non-interactive]

FLAGS
  -e, --profile=PROFILE_NAME  Name of the build profile from eas.json. Defaults to "production" if defined in eas.json.
  -p, --platform=<option>     <options: android|ios>
      --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies
                              --non-interactive.
      --non-interactive       Run the command in non-interactive mode.

DESCRIPTION
  display project configuration (app.json + eas.json)
```

_See code: [packages/eas-cli/src/commands/config.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/config.ts)_

## `eas credentials`

manage credentials

```
USAGE
  $ eas credentials [-p android|ios]

FLAGS
  -p, --platform=<option>  <options: android|ios>

DESCRIPTION
  manage credentials
```

_See code: [packages/eas-cli/src/commands/credentials/index.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/credentials/index.ts)_

## `eas credentials:configure-build`

set up credentials for building your project

```
USAGE
  $ eas credentials:configure-build [-p android|ios] [-e PROFILE_NAME]

FLAGS
  -e, --profile=PROFILE_NAME  The name of the build profile in eas.json.
  -p, --platform=<option>     <options: android|ios>

DESCRIPTION
  set up credentials for building your project
```

_See code: [packages/eas-cli/src/commands/credentials/configure-build.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/credentials/configure-build.ts)_

## `eas deploy [options]`

deploy your Expo Router web build and API Routes

```
USAGE
  $ eas deploy [options]
  $ eas deploy --prod
  $ eas deploy --non-interactive --dev-domain my-app

FLAGS
  --alias=name           Custom alias to assign to the new deployment.
  --dev-domain=name      Custom preview URL subdomain to assign to the project on its first deployment, e.g. "my-app"
                         for my-app.expo.app. Required with --non-interactive if you want to customize the preview URL.
  --dry-run              Outputs a tarball of the new deployment instead of uploading it.
  --environment=<value>  Environment variable's environment, e.g. 'production', 'preview', 'development'
  --export-dir=dir       [default: dist] Directory where the Expo project was exported.
  --id=xyz123            Custom unique identifier for the new deployment.
  --json                 Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive      Run the command in non-interactive mode.
  --prod                 Create a new production deployment.
  --[no-]source-maps     Include source maps in the deployment.

DESCRIPTION
  deploy your Expo Router web build and API Routes

ALIASES
  $ eas worker:deploy
```

_See code: [packages/eas-cli/src/commands/deploy/index.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/deploy/index.ts)_

## `eas deploy:alias`

assign deployment aliases

```
USAGE
  $ eas deploy:alias [--prod] [--alias name] [--id xyz123] [--json] [--non-interactive]

FLAGS
  --alias=name       Custom alias to assign to the existing deployment.
  --id=xyz123        Unique identifier of an existing deployment.
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.
  --prod             Promote an existing deployment to production.

DESCRIPTION
  assign deployment aliases

ALIASES
  $ eas worker:alias
  $ eas deploy:promote
```

_See code: [packages/eas-cli/src/commands/deploy/alias/index.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/deploy/alias/index.ts)_

## `eas deploy:alias:delete [ALIAS_NAME]`

delete deployment aliases

```
USAGE
  $ eas deploy:alias:delete [ALIAS_NAME] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  delete deployment aliases

ALIASES
  $ eas worker:alias:delete
```

_See code: [packages/eas-cli/src/commands/deploy/alias/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/deploy/alias/delete.ts)_

## `eas deploy:delete [DEPLOYMENT_ID]`

delete a deployment

```
USAGE
  $ eas deploy:delete [DEPLOYMENT_ID] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  delete a deployment

ALIASES
  $ eas worker:delete
```

_See code: [packages/eas-cli/src/commands/deploy/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/deploy/delete.ts)_

## `eas deploy:promote`

assign deployment aliases

```
USAGE
  $ eas deploy:promote [--prod] [--alias name] [--id xyz123] [--json] [--non-interactive]

DESCRIPTION
  assign deployment aliases

ALIASES
  $ eas worker:alias
  $ eas deploy:promote
```

## `eas device:create`

```
USAGE
  $ eas device:create

DESCRIPTION
  register new Apple Devices to use for internal distribution
```

_See code: [packages/eas-cli/src/commands/device/create.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/device/create.ts)_

## `eas device:delete`

remove a registered device from your account

```
USAGE
  $ eas device:delete [--apple-team-id <value>] [--udid <value>] [--json] [--non-interactive]

FLAGS
  --apple-team-id=<value>  The Apple team ID on which to find the device
  --json                   Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive        Run the command in non-interactive mode.
  --udid=<value>           The Apple device ID to disable

DESCRIPTION
  remove a registered device from your account
```

_See code: [packages/eas-cli/src/commands/device/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/device/delete.ts)_

## `eas device:list`

list all registered devices for your account

```
USAGE
  $ eas device:list [--apple-team-id <value>] [--offset <value>] [--limit <value>] [--json] [--non-interactive]

FLAGS
  --apple-team-id=<value>
  --json                   Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>          The number of items to fetch each query. Defaults to 50 and is capped at 100.
  --non-interactive        Run the command in non-interactive mode.
  --offset=<value>         Start queries from specified index. Use for paginating results. Defaults to 0.

DESCRIPTION
  list all registered devices for your account
```

_See code: [packages/eas-cli/src/commands/device/list.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/device/list.ts)_

## `eas device:rename`

rename a registered device

```
USAGE
  $ eas device:rename [--apple-team-id <value>] [--udid <value>] [--name <value>] [--json] [--non-interactive]

FLAGS
  --apple-team-id=<value>  The Apple team ID on which to find the device
  --json                   Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --name=<value>           The new name for the device
  --non-interactive        Run the command in non-interactive mode.
  --udid=<value>           The Apple device ID to rename

DESCRIPTION
  rename a registered device
```

_See code: [packages/eas-cli/src/commands/device/rename.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/device/rename.ts)_

## `eas device:view [UDID]`

view a device for your project

```
USAGE
  $ eas device:view [UDID]

DESCRIPTION
  view a device for your project
```

_See code: [packages/eas-cli/src/commands/device/view.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/device/view.ts)_

## `eas diagnostics`

display environment info

```
USAGE
  $ eas diagnostics

DESCRIPTION
  display environment info
```

_See code: [packages/eas-cli/src/commands/diagnostics.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/diagnostics.ts)_

## `eas env:delete [ENVIRONMENT]`

delete an environment variable for the current project or account

```
USAGE
  $ eas env:delete [ENVIRONMENT] [--variable-name <value>] [--variable-environment <value>] [--scope
    project|account] [--non-interactive]

ARGUMENTS
  [ENVIRONMENT]  Current environment of the variable to delete. Default environments are 'production', 'preview', and
                 'development'.

FLAGS
  --non-interactive               Run the command in non-interactive mode.
  --scope=<option>                [default: project] Scope for the variable
                                  <options: project|account>
  --variable-environment=<value>  Current environment of the variable to delete
  --variable-name=<value>         Name of the variable to delete

DESCRIPTION
  delete an environment variable for the current project or account
```

_See code: [packages/eas-cli/src/commands/env/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/delete.ts)_

## `eas env:exec ENVIRONMENT BASH_COMMAND`

execute a command with environment variables from the selected environment

```
USAGE
  $ eas env:exec ENVIRONMENT BASH_COMMAND [--non-interactive]

ARGUMENTS
  ENVIRONMENT   Environment to execute the command in. Default environments are 'production', 'preview', and
                'development'.
  BASH_COMMAND  bash command to execute with the environment variables from the environment

FLAGS
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  execute a command with environment variables from the selected environment
```

_See code: [packages/eas-cli/src/commands/env/exec.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/exec.ts)_

## `eas env:get [ENVIRONMENT]`

view an environment variable for the current project or account

```
USAGE
  $ eas env:get [ENVIRONMENT] [--variable-name <value>] [--variable-environment <value>] [--format
    long|short] [--scope project|account] [--non-interactive]

ARGUMENTS
  [ENVIRONMENT]  Current environment of the variable. Default environments are 'production', 'preview', and
                 'development'.

FLAGS
  --format=<option>               [default: short] Output format
                                  <options: long|short>
  --non-interactive               Run the command in non-interactive mode.
  --scope=<option>                [default: project] Scope for the variable
                                  <options: project|account>
  --variable-environment=<value>  Current environment of the variable
  --variable-name=<value>         Name of the variable

DESCRIPTION
  view an environment variable for the current project or account
```

_See code: [packages/eas-cli/src/commands/env/get.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/get.ts)_

## `eas env:list [ENVIRONMENT]`

list environment variables for the current project or account

```
USAGE
  $ eas env:list [ENVIRONMENT] [--include-sensitive] [--include-file-content] [--environment <value>...]
    [--format long|short] [--scope project|account]

ARGUMENTS
  [ENVIRONMENT]  Environment to list the variables from. Default environments are 'production', 'preview', and
                 'development'.

FLAGS
  --environment=<value>...  Environment variable's environment, e.g. 'production', 'preview', 'development'
  --format=<option>         [default: short] Output format
                            <options: long|short>
  --include-file-content    Display files content in the output
  --include-sensitive       Display sensitive values in the output
  --scope=<option>          [default: project] Scope for the variable
                            <options: project|account>

DESCRIPTION
  list environment variables for the current project or account
```

_See code: [packages/eas-cli/src/commands/env/list.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/list.ts)_

## `eas env:pull [ENVIRONMENT]`

pull environment variables for the selected environment to .env file

```
USAGE
  $ eas env:pull [ENVIRONMENT] [--non-interactive] [--environment <value>] [--path <value>]

ARGUMENTS
  [ENVIRONMENT]  Environment to pull variables from. Default environments are 'production', 'preview', and
                 'development'.

FLAGS
  --environment=<value>  Environment variable's environment, e.g. 'production', 'preview', 'development'
  --non-interactive      Run the command in non-interactive mode.
  --path=<value>         [default: .env.local] Path to the result `.env` file

DESCRIPTION
  pull environment variables for the selected environment to .env file
```

_See code: [packages/eas-cli/src/commands/env/pull.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/pull.ts)_

## `eas env:push [ENVIRONMENT]`

push environment variables from .env file to the selected environment

```
USAGE
  $ eas env:push [ENVIRONMENT] [--environment <value>...] [--path <value>] [--force]

ARGUMENTS
  [ENVIRONMENT]  Environment to push variables to. Default environments are 'production', 'preview', and 'development'.

FLAGS
  --environment=<value>...  Environment variable's environment, e.g. 'production', 'preview', 'development'
  --force                   Skip confirmation and automatically override existing variables
  --path=<value>            [default: .env.local] Path to the input `.env` file

DESCRIPTION
  push environment variables from .env file to the selected environment
```

_See code: [packages/eas-cli/src/commands/env/push.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/push.ts)_

## `eas env:set [ENVIRONMENT]`

set (create or update) an environment variable on the current project or account

```
USAGE
  $ eas env:set [ENVIRONMENT] [--name <value>] [--value <value>] [--type string|file] [--visibility
    plaintext|sensitive|secret] [--scope project|account] [--environment <value>...] [--json] [--non-interactive]

ARGUMENTS
  [ENVIRONMENT]  Environment to set the variable in. Default environments are 'production', 'preview', and
                 'development'.

FLAGS
  --environment=<value>...  Environment variable's environment, e.g. 'production', 'preview', 'development'
  --json                    Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --name=<value>            Name of the variable
  --non-interactive         Run the command in non-interactive mode.
  --scope=<option>          [default: project] Scope for the variable
                            <options: project|account>
  --type=<option>           The type of variable
                            <options: string|file>
  --value=<value>           Text value of the variable
  --visibility=<option>     Visibility of the variable
                            <options: plaintext|sensitive|secret>

DESCRIPTION
  set (create or update) an environment variable on the current project or account
```

_See code: [packages/eas-cli/src/commands/env/set.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/env/set.ts)_

## `eas fingerprint:compare [HASH1] [HASH2]`

compare fingerprints of the current project, builds, and updates

```
USAGE
  $ eas fingerprint:compare [HASH1...] [HASH2...] [--build-id <value>...] [--update-id <value>...] [--open]
    [--environment <value>] [--json] [--non-interactive]

ARGUMENTS
  [HASH1...]  If provided alone, HASH1 is compared against the current project's fingerprint.
  [HASH2...]  If two hashes are provided, HASH1 is compared against HASH2.

FLAGS
  --build-id=<value>...   Compare the fingerprint with the build with the specified ID
  --environment=<value>   If generating a fingerprint from the local directory, use the specified environment.
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive       Run the command in non-interactive mode.
  --open                  Open the fingerprint comparison in the browser
  --update-id=<value>...  Compare the fingerprint with the update with the specified ID

DESCRIPTION
  compare fingerprints of the current project, builds, and updates

EXAMPLES
  $ eas fingerprint:compare 	 # Compare fingerprints in interactive mode

$ eas fingerprint:compare <FINGERPRINT-HASH> 	 # Compare fingerprint against local directory

$ eas fingerprint:compare <FINGERPRINT-HASH-1> <FINGERPRINT-HASH-2> 	 # Compare provided fingerprints

$ eas fingerprint:compare --build-id <BUILD-ID> 	 # Compare fingerprint from build against local directory

$ eas fingerprint:compare --build-id <BUILD-ID> --environment production 	 # Compare fingerprint from build against local directory with the "production" environment

$ eas fingerprint:compare --build-id <BUILD-ID-1> --build-id <BUILD-ID-2>	 # Compare fingerprint from a build against another build

$ eas fingerprint:compare --build-id <BUILD-ID> --update-id <UPDATE-ID>	 # Compare fingerprint from build against fingerprint from update

$ eas fingerprint:compare <FINGERPRINT-HASH> --update-id <UPDATE-ID> 	 # Compare fingerprint from update against provided fingerprint
```

_See code: [packages/eas-cli/src/commands/fingerprint/compare.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/fingerprint/compare.ts)_

## `eas fingerprint:generate`

generate fingerprints from the current project

```
USAGE
  $ eas fingerprint:generate [-p android|ios] [--environment <value> | -e <value>] [--json] [--non-interactive]

FLAGS
  -e, --build-profile=<value>  Name of the build profile from eas.json.
  -p, --platform=<option>      <options: android|ios>
      --environment=<value>    Environment variable's environment, e.g. 'production', 'preview', 'development'
      --json                   Enable JSON output, non-JSON messages will be printed to stderr. Implies
                               --non-interactive.
      --non-interactive        Run the command in non-interactive mode.

DESCRIPTION
  generate fingerprints from the current project

EXAMPLES
  $ eas fingerprint:generate  	 # Generate fingerprint in interactive mode

$ eas fingerprint:generate --build-profile preview  	 # Generate a fingerprint using the "preview" build profile

$ eas fingerprint:generate --environment preview  	 # Generate a fingerprint using the "preview" environment

$ eas fingerprint:generate --json --non-interactive --platform android  	 # Output fingerprint json to stdout
```

_See code: [packages/eas-cli/src/commands/fingerprint/generate.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/fingerprint/generate.ts)_

## `eas help [COMMAND]`

Display help for eas.

```
USAGE
  $ eas help [COMMAND...] [-n]

ARGUMENTS
  [COMMAND...]  Command to show help for.

FLAGS
  -n, --nested-commands  Include all nested commands in the output.

DESCRIPTION
  Display help for eas.
```

_See code: [@expo/plugin-help](https://github.com/expo/oclif-plugin-help/blob/v5.1.23/src/commands/help.ts)_

## `eas init`

create or link an EAS project

```
USAGE
  $ eas init [--account <value> | --id <value>] [--force] [--icon] [--json] [--non-interactive]

FLAGS
  --account=<value>  Name of the account that will own the project
  --force            Whether to create a new project/link an existing project without additional prompts or overwrite
                     any existing project ID when running with --id flag
  --[no-]icon        Set the icon shown on the EAS dashboard from the app config, when the project does not have one yet
  --id=<value>       ID of the EAS project to link
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  create or link an EAS project

ALIASES
  $ eas init

EXAMPLES
  $ eas init  	 # Create or link a project interactively

$ eas init --id <project-id>  	 # Link to the project with the given ID

$ eas init --account my-account --non-interactive  	 # Create or link @my-account/<slug> without prompts

$ eas init --account my-account --json --non-interactive  	 # Same, and print the result as JSON to stdout
```

## `eas integrations:asc:connect`

connect a project to an App Store Connect app

```
USAGE
  $ eas integrations:asc:connect [--api-key-id <value>] [--asc-app-id <value>] [--bundle-id <value>] [--json]
    [--non-interactive]

FLAGS
  --api-key-id=<value>  Apple App Store Connect API Key ID
  --asc-app-id=<value>  App Store Connect app identifier
  --bundle-id=<value>   Filter discovered apps by bundle identifier
  --json                Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive     Run the command in non-interactive mode.

DESCRIPTION
  connect a project to an App Store Connect app
```

_See code: [packages/eas-cli/src/commands/integrations/asc/connect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/asc/connect.ts)_

## `eas integrations:asc:disconnect`

disconnect the current project from its App Store Connect app

```
USAGE
  $ eas integrations:asc:disconnect [--yes] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.
  --yes              Skip confirmation prompt

DESCRIPTION
  disconnect the current project from its App Store Connect app
```

_See code: [packages/eas-cli/src/commands/integrations/asc/disconnect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/asc/disconnect.ts)_

## `eas integrations:asc:status`

show the App Store Connect app link status for the current project

```
USAGE
  $ eas integrations:asc:status [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  show the App Store Connect app link status for the current project
```

_See code: [packages/eas-cli/src/commands/integrations/asc/status.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/asc/status.ts)_

## `eas integrations:convex:connect`

connect Convex to your Expo project

```
USAGE
  $ eas integrations:convex:connect [--non-interactive] [--region aws-us-east-1|aws-eu-west-1] [--team-name <value>]
    [--project-name <value>]

FLAGS
  --non-interactive       Run the command in non-interactive mode.
  --project-name=<value>  Name for the Convex project (defaults to app slug)
  --region=<option>       Convex deployment region (e.g. aws-us-east-1, aws-eu-west-1)
                          <options: aws-us-east-1|aws-eu-west-1>
  --team-name=<value>     Name for the new Convex team (defaults to EAS account name)

DESCRIPTION
  connect Convex to your Expo project
```

_See code: [packages/eas-cli/src/commands/integrations/convex/connect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/connect.ts)_

## `eas integrations:convex:dashboard`

open the Convex dashboard for the linked Convex project

```
USAGE
  $ eas integrations:convex:dashboard

DESCRIPTION
  open the Convex dashboard for the linked Convex project
```

_See code: [packages/eas-cli/src/commands/integrations/convex/dashboard.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/dashboard.ts)_

## `eas integrations:convex:project`

display the Convex project linked to the current Expo app

```
USAGE
  $ eas integrations:convex:project

DESCRIPTION
  display the Convex project linked to the current Expo app
```

_See code: [packages/eas-cli/src/commands/integrations/convex/project.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/project.ts)_

## `eas integrations:convex:project:delete`

remove the Convex project link for the current Expo app from EAS servers

```
USAGE
  $ eas integrations:convex:project:delete [--non-interactive] [-y]

FLAGS
  -y, --yes              Skip confirmation prompt
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  remove the Convex project link for the current Expo app from EAS servers
```

_See code: [packages/eas-cli/src/commands/integrations/convex/project/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/project/delete.ts)_

## `eas integrations:convex:team`

display Convex teams linked to the current Expo app's owner account

```
USAGE
  $ eas integrations:convex:team

DESCRIPTION
  display Convex teams linked to the current Expo app's owner account
```

_See code: [packages/eas-cli/src/commands/integrations/convex/team.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/team.ts)_

## `eas integrations:convex:team:delete [CONVEX_TEAM]`

remove a Convex team link from the current Expo app owner account's EAS servers

```
USAGE
  $ eas integrations:convex:team:delete [CONVEX_TEAM] [--non-interactive] [-y]

ARGUMENTS
  [CONVEX_TEAM]  Slug of the Convex team to remove

FLAGS
  -y, --yes              Skip confirmation prompt
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  remove a Convex team link from the current Expo app owner account's EAS servers
```

_See code: [packages/eas-cli/src/commands/integrations/convex/team/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/team/delete.ts)_

## `eas integrations:convex:team:invite [CONVEX_TEAM]`

send a Convex team invitation to your verified email address

```
USAGE
  $ eas integrations:convex:team:invite [CONVEX_TEAM] [--non-interactive]

ARGUMENTS
  [CONVEX_TEAM]  Slug of the Convex team to invite yourself to

FLAGS
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  send a Convex team invitation to your verified email address
```

_See code: [packages/eas-cli/src/commands/integrations/convex/team/invite.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/convex/team/invite.ts)_

## `eas integrations:posthog:connect`

connect PostHog to your Expo project

```
USAGE
  $ eas integrations:posthog:connect [--json] [--non-interactive] [--region US|EU] [--session-replay] [--error-tracking]
    [--posthog-cli-api-key <value>] [--overwrite]

FLAGS
  --[no-]error-tracking          Set up PostHog error tracking / source maps (requires a personal API key)
  --json                         Enable JSON output, non-JSON messages will be printed to stderr. Implies
                                 --non-interactive.
  --non-interactive              Run the command in non-interactive mode.
  --overwrite                    Overwrite existing PostHog environment variables without prompting
  --posthog-cli-api-key=<value>  PostHog personal API key for error-tracking source-map uploads (enables error tracking
                                 non-interactively)
  --region=<option>              PostHog region
                                 <options: US|EU>
  --[no-]session-replay          Set up PostHog session replay (default: yes)

DESCRIPTION
  connect PostHog to your Expo project
```

_See code: [packages/eas-cli/src/commands/integrations/posthog/connect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/posthog/connect.ts)_

## `eas integrations:posthog:dashboard`

open the PostHog dashboard for the linked PostHog project

```
USAGE
  $ eas integrations:posthog:dashboard [--show-link] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.
  --show-link        Print the signed-in dashboard URL in addition to opening it. The URL contains a single-use login
                     token.

DESCRIPTION
  open the PostHog dashboard for the linked PostHog project
```

_See code: [packages/eas-cli/src/commands/integrations/posthog/dashboard.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/posthog/dashboard.ts)_

## `eas integrations:posthog:disconnect`

remove the PostHog project link for the current Expo app from EAS servers

```
USAGE
  $ eas integrations:posthog:disconnect [--json] [--non-interactive] [-y]

FLAGS
  -y, --yes              Skip confirmation prompt
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  remove the PostHog project link for the current Expo app from EAS servers
```

_See code: [packages/eas-cli/src/commands/integrations/posthog/disconnect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/posthog/disconnect.ts)_

## `eas integrations:supabase:advisors`

list unresolved findings from the Supabase Security and Performance Advisors for this app's primary Supabase project

```
USAGE
  $ eas integrations:supabase:advisors [--type security|performance] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.
  --type=<option>    Only show one advisor
                     <options: security|performance>

DESCRIPTION
  list unresolved findings from the Supabase Security and Performance Advisors for this app's primary Supabase project

EXAMPLES
  $ eas integrations:supabase:advisors

$ eas integrations:supabase:advisors --type security

$ eas integrations:supabase:advisors --json --non-interactive
```

_See code: [packages/eas-cli/src/commands/integrations/supabase/advisors.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/supabase/advisors.ts)_

## `eas integrations:supabase:connect`

authorize Supabase, link or provision a project, install the SDK, and write EXPO_PUBLIC_SUPABASE_URL / EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY

```
USAGE
  $ eas integrations:supabase:connect [--json] [--non-interactive] [--region <value>] [--organization <value>] [--link <value>]
    [--reauth] [--overwrite] [--environment <value>]

FLAGS
  --environment=<value>   EAS environments for a separate hosted project (e.g. preview). Requires prior primary connect;
                          writes URL/key only there. Incompatible with --link and --reauth
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --link=<value>          Existing project URL or Reference ID (Project Settings → General). Sets the app primary
                          instead of provisioning. Incompatible with --environment
  --non-interactive       Run the command in non-interactive mode.
  --organization=<value>  Supabase org slug for a new primary project. Ignored with --link; incompatible with
                          --environment
  --overwrite             Replace existing EXPO_PUBLIC_SUPABASE_* in .env.local and EAS without prompting
  --reauth                Disconnect the existing Supabase OAuth connection, then re-authorize in the browser. Removes
                          the EAS connection and primary project link (Supabase projects are kept). Then prompts to link
                          an existing project (default) or provision a new one; pass --link to skip the prompt.
                          Interactive only; incompatible with --environment
  --region=<value>        Region when provisioning (americas | emea | apac, or e.g. us-east-1). Required with
                          --non-interactive if provisioning. Ignored with --link or if already linked

DESCRIPTION
  authorize Supabase, link or provision a project, install the SDK, and write EXPO_PUBLIC_SUPABASE_URL /
  EXPO_PUBLIC_SUPABASE_PUBLISHABLE_KEY

EXAMPLES
  $ eas integrations:supabase:connect

$ eas integrations:supabase:connect --link <project-url>

$ eas integrations:supabase:connect --environment preview

$ eas integrations:supabase:connect --environment preview --region americas --non-interactive --overwrite

$ eas integrations:supabase:connect --reauth
```

_See code: [packages/eas-cli/src/commands/integrations/supabase/connect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/supabase/connect.ts)_

## `eas integrations:supabase:dashboard`

open this app's primary Supabase project in the dashboard (or print the URL with --non-interactive)

```
USAGE
  $ eas integrations:supabase:dashboard [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  open this app's primary Supabase project in the dashboard (or print the URL with --non-interactive)

EXAMPLES
  $ eas integrations:supabase:dashboard

$ eas integrations:supabase:dashboard --non-interactive
```

_See code: [packages/eas-cli/src/commands/integrations/supabase/dashboard.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/supabase/dashboard.ts)_

## `eas integrations:supabase:disconnect`

remove this app's Supabase project link from EAS (keeps the Supabase project; does not delete EXPO_PUBLIC_SUPABASE_* env vars)

```
USAGE
  $ eas integrations:supabase:disconnect [--json] [--non-interactive] [-y]

DESCRIPTION
  remove this app's Supabase project link from EAS (keeps the Supabase project; does not delete EXPO_PUBLIC_SUPABASE_*
  env vars)

EXAMPLES
  $ eas integrations:supabase:disconnect

$ eas integrations:supabase:disconnect --yes
```

_See code: [packages/eas-cli/src/commands/integrations/supabase/disconnect.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/integrations/supabase/disconnect.ts)_

## `eas login`

```
USAGE
  $ eas login [--non-interactive] [--match <value>  [--resume <value> [--device | -s]]] [-b]

DESCRIPTION
  log in with your Expo account

ALIASES
  $ eas login

EXAMPLES
  $ eas login --device

$ eas login --device --non-interactive

$ eas login --device --non-interactive --resume REQUEST_ID --match NUMBER_FROM_USER
```

## `eas logout`

log out

```
USAGE
  $ eas logout

DESCRIPTION
  log out

ALIASES
  $ eas logout
```

## `eas metadata:lint`

validate the local store configuration

```
USAGE
  $ eas metadata:lint [--json] [--profile <value>]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr
  --profile=<value>  Name of the submit profile from eas.json. Defaults to "production" if defined in eas.json.

DESCRIPTION
  validate the local store configuration
```

_See code: [packages/eas-cli/src/commands/metadata/lint.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/metadata/lint.ts)_

## `eas metadata:pull`

generate the local store configuration from the app stores

```
USAGE
  $ eas metadata:pull [-e <value>] [--non-interactive]

FLAGS
  -e, --profile=<value>  Name of the submit profile from eas.json. Defaults to "production" if defined in eas.json.
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  generate the local store configuration from the app stores
```

_See code: [packages/eas-cli/src/commands/metadata/pull.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/metadata/pull.ts)_

## `eas metadata:push`

sync the local store configuration to the app stores

```
USAGE
  $ eas metadata:push [-e <value>] [--non-interactive]

FLAGS
  -e, --profile=<value>  Name of the submit profile from eas.json. Defaults to "production" if defined in eas.json.
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  sync the local store configuration to the app stores
```

_See code: [packages/eas-cli/src/commands/metadata/push.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/metadata/push.ts)_

## `eas new [PATH]`

create a new project configured with Expo Application Services (EAS)

```
USAGE
  $ eas new [PATH] [-p bun|npm|pnpm|yarn] [--sdk-version <value>]

ARGUMENTS
  [PATH]  Path to create the project (defaults to current directory)

FLAGS
  -p, --package-manager=<option>  [default: npm] Package manager to use for installing dependencies
                                  <options: bun|npm|pnpm|yarn>
      --sdk-version=<value>       Expo SDK version to use for the new project (e.g. 57, or "latest")

DESCRIPTION
  create a new project configured with Expo Application Services (EAS)

ALIASES
  $ eas new
```

## `eas observe:errors`

display error and exception issue groups (grouped by fingerprint) for the app

FLAGS
  --after=<value>         Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --app-version=<value>   Filter by app version
  --build-number=<value>  Filter by app build number
  --days=<value>          Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>           End of time range (ISO date)
  --environment=<value>   Filter by environment (e.g. production, development)
  --fingerprint=<value>   Show individual occurrences (with stack traces) for this error group fingerprint instead of
                          the grouped summary
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>         The number of items to fetch each query. Defaults to 10 and is capped at 100.
  --non-interactive       Run the command in non-interactive mode.
  --platform=<option>     Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                          <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>    EAS project ID (defaults to the project ID of the current directory)
  --severity=<option>     Filter by severity (ignored when --fingerprint is set)
                          <options: fatal|error>
  --start=<value>         Start of time range (ISO date)
  --update-id=<value>     Filter by EAS update ID

DESCRIPTION
  display error and exception issue groups (grouped by fingerprint) for the app
```

_See code: [packages/eas-cli/src/commands/observe/errors.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/errors.ts)_

## `eas observe:event ID`

display a single Observe event (metric, log, or error) by its ID. IDs are included in event data when the `--json` flag is passed to `eas observe:session`, `eas observe:metrics`, or `eas observe:events`

```
USAGE
  $ eas observe:event ID [--project-id <value>] [--json] [--non-interactive]

ARGUMENTS
  ID  ID of the event to display

FLAGS
  --json                Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive     Run the command in non-interactive mode.
  --project-id=<value>  EAS project ID (defaults to the project ID of the current directory)

DESCRIPTION
  display a single Observe event (metric, log, or error) by its ID. IDs are included in event data when the `--json`
  flag is passed to `eas observe:session`, `eas observe:metrics`, or `eas observe:events`
```

_See code: [packages/eas-cli/src/commands/observe/event.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/event.ts)_

## `eas observe:events [EVENTNAME]`

display individual events emitted by the app via `logEvent`, filtered by the event name in the argument. With no arguments, a list of the available event names and associated event counts is returned

```
USAGE
  $ eas observe:events [EVENTNAME] [--platform android|ios|ipados|macos|tvos|apple] [--after <value>] [--limit
    <value>] [--start <value> | --days <value>] [--end <value> | ] [--app-version <value>] [--build-number <value>]
    [--update-id <value>] [--environment <value>] [--session-id <value>] [--all-events] [--project-id <value>] [--json]
    [--non-interactive]

ARGUMENTS
  [EVENTNAME]  Event name to filter by

FLAGS
  --after=<value>         Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --all-events            When no event name argument is provided, list all events across all event names instead of a
                          summary of event names + counts.
  --app-version=<value>   Filter by app version
  --build-number=<value>  Filter by app build number
  --days=<value>          Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>           End of time range (ISO date)
  --environment=<value>   Filter by environment (e.g. production, development)
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>         The number of items to fetch each query. Defaults to 10 and is capped at 100.
  --non-interactive       Run the command in non-interactive mode.
  --platform=<option>     Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                          <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>    EAS project ID (defaults to the project ID of the current directory)
  --session-id=<value>    Filter by session ID. When no event name is given, lists the events in the session instead of
                          the event-name summary.
  --start=<value>         Start of time range (ISO date)
  --update-id=<value>     Filter by EAS update ID

DESCRIPTION
  display individual events emitted by the app via `logEvent`, filtered by the event name in the argument. With no
  arguments, a list of the available event names and associated event counts is returned
```

_See code: [packages/eas-cli/src/commands/observe/events.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/events.ts)_

## `eas observe:metrics [METRIC]`

display individual performance metric samples ordered by value

FLAGS
  --after=<value>         Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --app-version=<value>   Filter by app version
  --build-number=<value>  Filter by app build number
  --days=<value>          Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>           End of time range (ISO date)
  --environment=<value>   Filter by environment (e.g. production, development)
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>         The number of items to fetch each query. Defaults to 10 and is capped at 100.
  --non-interactive       Run the command in non-interactive mode.
  --platform=<option>     Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                          <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>    EAS project ID (defaults to the project ID of the current directory)
  --sort=<option>         [default: oldest] Sort order for events
                          <options: slowest|fastest|newest|oldest>
  --start=<value>         Start of time range (ISO date)
  --update-id=<value>     Filter by EAS update ID

DESCRIPTION
  display individual performance metric samples ordered by value
```

_See code: [packages/eas-cli/src/commands/observe/metrics.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/metrics.ts)_

## `eas observe:metrics-summary`

display aggregated performance metric statistics grouped by app version

FLAGS
  --days=<value>         Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>          End of time range (ISO date)
  --environment=<value>  Filter by environment (e.g. production, development)
  --json                 Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --metric=<option>...   Metric name to display (can be specified multiple times).
                         <options:
                         nav_cold_ttr|nav_warm_ttr|nav_tti|tti|ttr|cold_launch|warm_launch|bundle_load|update_download>
  --non-interactive      Run the command in non-interactive mode.
  --platform=<option>    Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                         <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>   EAS project ID (defaults to the project ID of the current directory)
  --start=<value>        Start of time range (ISO date)
  --stat=<option>...     Statistic to display per metric (can be specified multiple times)
                         <options: min|median|max|average|p80|p90|p99|eventCount>

DESCRIPTION
  display aggregated performance metric statistics grouped by app version
```

_See code: [packages/eas-cli/src/commands/observe/metrics-summary.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/metrics-summary.ts)_

## `eas observe:routes`

display app navigation route metrics (Cold TTR, Warm TTR, TTI) grouped by route name

FLAGS
  --after=<value>          Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --app-version=<value>    Filter by app version
  --build-number=<value>   Filter by app build number
  --days=<value>           Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>            End of time range (ISO date)
  --environment=<value>    Filter by environment (e.g. production, development)
  --json                   Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>          The number of items to fetch each query. Defaults to 50 and is capped at 200.
  --metric=<option>...     Navigation metric to display (can be specified multiple times). Defaults to all three.
                           <options: nav_cold_ttr|nav_warm_ttr|nav_tti>
  --non-interactive        Run the command in non-interactive mode.
  --platform=<option>      Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                           <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>     EAS project ID (defaults to the project ID of the current directory)
  --route-name=<value>...  Filter by route name (can be specified multiple times to include several routes)
  --start=<value>          Start of time range (ISO date)
  --stat=<option>...       Statistic to display per metric (can be specified multiple times)
                           <options: median|med|p90|count|event_count|eventCount>
  --update-id=<value>      Filter by EAS update ID

DESCRIPTION
  display app navigation route metrics (Cold TTR, Warm TTR, TTI) grouped by route name
```

_See code: [packages/eas-cli/src/commands/observe/routes.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/routes.ts)_

## `eas observe:session [SESSIONID]`

display the timeline of metric, log, and request trace span events for a specific session

ARGUMENTS
  [SESSIONID]  Session ID to inspect (omit in interactive mode to pick one from a list)

FLAGS
  --days=<value>         Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>          End of time range (ISO date)
  --environment=<value>  Filter by environment (e.g. production, development)
  --event-name=<value>   Metric or log event name to pick candidate sessions by (e.g. tti, cold_launch, login_pressed).
                         If omitted in interactive mode, you will be prompted.
  --json                 Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive      Run the command in non-interactive mode.
  --project-id=<value>   EAS project ID (defaults to the project ID of the current directory)
  --sort=<option>        Sort order for candidate events when picking a session (if omitted in interactive mode, you
                         will be prompted)
                         <options: slowest|fastest|newest|oldest>
  --start=<value>        Start of time range (ISO date)

DESCRIPTION
  display the timeline of metric, log, and request trace span events for a specific session
```

_See code: [packages/eas-cli/src/commands/observe/session.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/session.ts)_

## `eas observe:trace TRACEID`

display every span of a single request trace by its trace ID, oldest first, with child spans indented under their parent. Trace IDs are shown by `eas observe:traces`. In `--json` output a span with no `parentSpanId` is a root span, and a span with no `http` object is not an HTTP request

```
USAGE
  $ eas observe:trace TRACEID [--project-id <value>] [--json] [--non-interactive]

ARGUMENTS
  TRACEID  ID of the trace to display

DESCRIPTION
  display every span of a single request trace by its trace ID, oldest first, with child spans indented under their
  parent. Trace IDs are shown by `eas observe:traces`. In `--json` output a span with no `parentSpanId` is a root span,
  and a span with no `http` object is not an HTTP request
```

_See code: [packages/eas-cli/src/commands/observe/trace.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/trace.ts)_

## `eas observe:traces`

display request trace spans recorded by the app, newest first. With no span filters, a summary of span names and kinds with counts is returned. Pass --all-spans or a span filter (--name, --kind, --status, --host, --http-status, --min-duration, --root-only, --session-id) to list individual spans

FLAGS
  --after=<value>           Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --all-spans               List individual spans instead of the summary of span names + counts, even with no span
                            filter
  --app-version=<value>     Filter by app version
  --build-number=<value>    Filter by app build number
  --days=<value>            Show results from the last N days (mutually exclusive with --start/--end)
  --end=<value>             End of time range (ISO date)
  --environment=<value>     Filter by environment (e.g. production, development)
  --host=<value>...         Filter by request host (can be specified multiple times)
  --http-status=<value>...  Filter by HTTP response status code (can be specified multiple times)
  --json                    Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --kind=<option>...        Filter by span kind (can be specified multiple times)
                            <options: client|consumer|internal|producer|server|unspecified>
  --limit=<value>           The number of items to fetch each query. Defaults to 20 and is capped at 100.
  --min-duration=<value>    Only spans that took at least this many milliseconds
  --name=<value>...         Filter by span name, such as GET or POST (can be specified multiple times)
  --non-interactive         Run the command in non-interactive mode.
  --platform=<option>       Filter by platform ("apple" covers iOS, iPadOS, tvOS, and macOS)
                            <options: android|ios|ipados|macos|tvos|apple>
  --project-id=<value>      EAS project ID (defaults to the project ID of the current directory)
  --root-only               Only root spans (spans with no parent)
  --session-id=<value>      Filter by session ID
  --start=<value>           Start of time range (ISO date)
  --status=<option>...      Filter by span status (can be specified multiple times)
                            <options: error|ok|unset>
  --update-id=<value>       Filter by EAS update ID

DESCRIPTION
  display request trace spans recorded by the app, newest first. With no span filters, a summary of span names and kinds
  with counts is returned. Pass --all-spans or a span filter (--name, --kind, --status, --host, --http-status,
  --min-duration, --root-only, --session-id) to list individual spans
```

_See code: [packages/eas-cli/src/commands/observe/traces.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/traces.ts)_

## `eas observe:versions`

display app versions with build and update details

DESCRIPTION
  display app versions with build and update details
```

_See code: [packages/eas-cli/src/commands/observe/versions.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/observe/versions.ts)_

## `eas project:delete [NAME]`

delete a project

```
USAGE
  $ eas project:delete [NAME] [--dangerously-confirm-deletion <value>] [--json] [--non-interactive]

ARGUMENTS
  [NAME]  Full name (@account/slug) or ID of the project to delete. Defaults to the project in the current directory.

FLAGS
  --dangerously-confirm-deletion=<value>  The project's full name (@account/slug), to confirm deletion. Required in
                                          non-interactive mode.
  --json                                  Enable JSON output, non-JSON messages will be printed to stderr. Implies
                                          --non-interactive.
  --non-interactive                       Run the command in non-interactive mode.

DESCRIPTION
  delete a project
```

_See code: [packages/eas-cli/src/commands/project/delete.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/delete.ts)_

## `eas project:icon:set PATH`

set the project icon displayed on the EAS dashboard

```
USAGE
  $ eas project:icon:set PATH [--non-interactive]

ARGUMENTS
  PATH  Path to the icon image (PNG or JPEG, at most 10 MB). Non-square images are center-cropped to a square.

FLAGS
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  set the project icon displayed on the EAS dashboard
```

_See code: [packages/eas-cli/src/commands/project/icon/set.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/icon/set.ts)_

## `eas project:info`

information about the current project

```
USAGE
  $ eas project:info

DESCRIPTION
  information about the current project
```

_See code: [packages/eas-cli/src/commands/project/info.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/info.ts)_

## `eas project:init`

create or link an EAS project

```
USAGE
  $ eas project:init [--account <value> | --id <value>] [--force] [--icon] [--json] [--non-interactive]

DESCRIPTION
  create or link an EAS project

ALIASES
  $ eas init

EXAMPLES
  $ eas init  	 # Create or link a project interactively

$ eas init --id <project-id>  	 # Link to the project with the given ID

$ eas init --account my-account --non-interactive  	 # Create or link @my-account/<slug> without prompts

$ eas init --account my-account --json --non-interactive  	 # Same, and print the result as JSON to stdout
```

_See code: [packages/eas-cli/src/commands/project/init.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/init.ts)_

## `eas project:new [PATH]`

create a new project configured with Expo Application Services (EAS)

```
USAGE
  $ eas project:new [PATH] [-p bun|npm|pnpm|yarn] [--sdk-version <value>]

ARGUMENTS
  [PATH]  Path to create the project (defaults to current directory)

DESCRIPTION
  create a new project configured with Expo Application Services (EAS)

ALIASES
  $ eas new
```

_See code: [packages/eas-cli/src/commands/project/new.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/new.ts)_

## `eas project:status`

show a snapshot of the project: recent builds, dev builds, workflow runs, submissions, and updates

```
USAGE
  $ eas project:status [--limit <value>] [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>    The number of items to show in each section. Defaults to 3 and is capped at 25.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  show a snapshot of the project: recent builds, dev builds, workflow runs, submissions, and updates

ALIASES
  $ eas status

EXAMPLES
  $ eas status 	 # Show a concise project snapshot

$ eas status --json 	 # Output a machine-readable snapshot for agents and automation

$ eas status --json --limit 10 	 # Include more activity from each section
```

_See code: [packages/eas-cli/src/commands/project/status.ts](https://github.com/expo/eas-cli/blob/v27.2.0/packages/eas-cli/src/commands/project/status.ts)_

## `eas sim:availability`

[EXPERIMENTAL] check whether EAS Simulator is enabled for the current project account

```
USAGE
  $ eas sim:availability [--json] [--non-interactive]

FLAGS
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  [EXPERIMENTAL] check whether EAS Simulator is enabled for the current project account

ALIASES
  $ eas sim:availability
```

## `eas sim:control [ACTION]`

[EXPERIMENTAL] run a serve-sim action on a remote iOS simulator session on EAS. Run without an action to list the actions the session supports. To save a screenshot locally, run `eas simulator:control screenshot.capture --output ./screenshot.png`

```
USAGE
  $ eas sim:control [ACTION...] [-h] [--id <value>] [--list] [--output <value>] [--json] [--non-interactive]

ARGUMENTS
  [ACTION...]  Action to run, followed by its values in order or as name=value. Omit to list the actions. Put -- before
               values that start with --.

FLAGS
  -h, --help             Show command help, or usage for the selected action from the session.
      --id=<value>       Simulator session ID. Defaults to .env.eas-simulator.
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --list             List the actions the session supports.
      --non-interactive  Run the command in non-interactive mode.
      --output=<value>   Local path to save a returned file. For screenshots, --output ./screenshot.png sets the local
                         filename; omit it to save with a generated filename in the current directory.

DESCRIPTION
  [EXPERIMENTAL] run a serve-sim action on a remote iOS simulator session on EAS. Run without an action to list the
  actions the session supports. To save a screenshot locally, run `eas simulator:control screenshot.capture --output
  ./screenshot.png`

ALIASES
  $ eas sim:control

EXAMPLES
  $ eas simulator:control

$ eas simulator:control --id <session-id>

$ eas simulator:control screenshot.capture --help

$ eas simulator:control clipboard.write -- --some-text

$ eas simulator:control hardwareKeyboard.set off

$ eas simulator:control permissions.set grant camera com.example.app

$ eas simulator:control app.install ./MyApp.ipa

$ eas simulator:control screenshot.capture --output ./screenshot.png

$ eas simulator:control screenshot.capture --output ./screenshot.png --id <session-id>
```

## `eas sim:egress`

[EXPERIMENTAL] run the local egress client for a simulator session to route proxied HTTP(S) requests through this machine

```
USAGE
  $ eas sim:egress [--config-type dotenv|env]

FLAGS
  --config-type=<option>  [default: dotenv] Read session credentials from .env.eas-simulator (dotenv) or the current
                          shell environment (env).
                          <options: dotenv|env>

DESCRIPTION
  [EXPERIMENTAL] run the local egress client for a simulator session to route proxied HTTP(S) requests through this
  machine

ALIASES
  $ eas sim:egress
```

## `eas sim:events`

[EXPERIMENTAL] show activity events from a remote simulator session

```
USAGE
  $ eas sim:events [--id <value>] [-f] [--json] [--non-interactive]

FLAGS
  -f, --follow           Keep watching for new events until the session ends.
      --id=<value>       Simulator session ID. Defaults to .env.eas-simulator.
      --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  [EXPERIMENTAL] show activity events from a remote simulator session

ALIASES
  $ eas sim:events
```

## `eas sim:exec`

[EXPERIMENTAL] execute a simulator command with .env.eas-simulator environment loaded

```
USAGE
  $ eas sim:exec

DESCRIPTION
  [EXPERIMENTAL] execute a simulator command with .env.eas-simulator environment loaded

ALIASES
  $ eas sim:exec
```

## `eas sim:get`

[EXPERIMENTAL] get info about a remote simulator session on EAS by its simulator session ID. Preview links follow the session's saved sharing preference

```
USAGE
  $ eas sim:get [--id <value>] [--json] [--non-interactive]

FLAGS
  --id=<value>       Simulator session ID. Defaults to .env.eas-simulator.
  --json             Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --non-interactive  Run the command in non-interactive mode.

DESCRIPTION
  [EXPERIMENTAL] get info about a remote simulator session on EAS by its simulator session ID. Preview links follow the
  session's saved sharing preference

ALIASES
  $ eas sim:get
```

## `eas sim:list`

[EXPERIMENTAL] list remote simulator sessions for the current project

FLAGS
  --after=<value>         Cursor for pagination. Use the endCursor from a previous query to fetch the next page.
  --json                  Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
  --limit=<value>         The number of items to fetch each query. Defaults to 10 and is capped at 100.
  --name=<value>          Filter by session name (case-insensitive prefix match)
  --non-interactive       Run the command in non-interactive mode.
  --platform=<option>...  Filter by device platform (repeatable)
                          <options: android|ios>
  --status=<option>...    Filter by session status (repeatable)
                          <options: new|queued|starting|in-progress|stopped|errored>
  --tag=<value>...        Filter by tag (repeatable). A session must carry every tag listed.
  --type=<option>...      Filter by session type (repeatable). All session types include a web preview. agent-device,
                          appium, and argent also include an automation interface; web-preview-only includes no
                          automation interface.
                          <options: agent-device|appium|argent|web-preview-only>

DESCRIPTION
  [EXPERIMENTAL] list remote simulator sessions for the current project

ALIASES
  $ eas sim:list
```

## `eas sim:logs`

[EXPERIMENTAL] show buffered logs from a remote iOS simulator session

```
USAGE
  $ eas sim:logs [--id <value>] [--artifact <value>] [-o <value>] [-f | --json] [--scope user-apps|all]
    [--limit <value>] [--timestamp] [--non-interactive]

FLAGS
  -f, --follow            Stream new logs. Start following before performing actions to collect them.
  -o, --output=<value>    Save a stopped session artifact to this path.
      --artifact=<value>  Artifact index to download from a stopped session (1-based).
      --id=<value>        Simulator session ID. Defaults to .env.eas-simulator.
      --json              Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.
      --limit=<value>     [default: 100] Maximum number of buffered log lines to show while the session runs.
      --non-interactive   Run the command in non-interactive mode.
      --scope=<option>    [default: user-apps] Show user app logs or all device logs while the session runs.
                          <options: user-apps|all>
      --timestamp         Show timestamps in live human-readable log output.

DESCRIPTION
  [EXPERIMENTAL] show buffered logs from a remote iOS simulator session

ALIASES
  $ eas sim:logs

EXAMPLES
  $ eas simulator:logs --follow

$ eas simulator:logs --json
```

## `eas sim:start`

[EXPERIMENTAL] start a remote simulator session on EAS and get instructions to connect to it. The default browser preview link requires sign-in

```
USAGE
  $ eas sim:start [-p android|ios] [--name <value>] [--tag <value>...] [--device <value>] [--system-image
    <value>] [--build-id <value> | --build-fingerprint <value> | --application-archive-url <value> | --expo-go]
    [--sdk-version <value>] [--launch-arg <value>...] [--open-url <value>] [--type
    agent-device|appium|argent|web-preview-only] [--package-version <value>] [--network-capture-field <value>...
    --network-capture] [--max-duration-minutes <value>] [--max-idle-time-minutes <value>] [--egress-allow <value>...
    --egress local] [--cors-origin <value>...] [--frame-ancestor <value>...] [--force] [--out-config-type env|dotenv]
    [--public-link] [--json] [--non-interactive]

FLAGS
  -p, --platform=<option>
      Device platform
      <options: android|ios>

--application-archive-url=<value>
      Application archive URL to download, install, and launch before the simulator session is ready.

--build-fingerprint=<value>
      Fingerprint hash of an EAS Build to install and launch before the simulator session is ready. Uses the most recent
      finished build with this fingerprint that can be installed on the simulator.

--build-id=<value>
      EAS Build to install and launch before the simulator session is ready.

--cors-origin=<value>...
      Origin of a page that may call the simulator preview API cross-origin, for example to render the device with
      @expo/hub-client, such as https://app.example.com or https://*.example.com. Repeat for multiple origins. Embedding
      the preview in a frame does not need this; use --frame-ancestor for that. The page still needs the printed preview
      URL and its token.

--device=<value>
      Virtual device to start for the session. On iOS, a Simulator device name or UDID (e.g. "iPhone 16 Pro"). On Android,
      an AVD hardware profile id (e.g. "pixel_7"). Defaults to a device chosen by the runner.

--egress=<option>
      With "local", the simulator's network traffic exits from this machine and fails while the egress client is
      disconnected. On iOS, the simulator system proxy points at this machine: HTTP(S) and WebSocket requests that honor
      it (WebKit, URLSession) and clients that read proxy environment variables (gRPC, libcurl) use it, and connections
      that ignore both are refused inside the simulator and listed, with the library that tried, in the Logs section of
      the session page on expo.dev. On Android, all TCP traffic from the emulator goes through its proxy to this machine;
      traffic that cannot (UDP, such as QUIC) is refused and listed in the same Logs section, and DNS for apps that ignore
      the system proxy resolves on the device host. The egress client must keep running for the life of the session.
      <options: local>

--egress-allow=<value>...
      Destination on this machine or its network that the simulator may reach through local egress, as an exact host:port
      (for example localhost:3000). Repeat for multiple destinations. A localhost or 127.0.0.1 entry also forwards that
      port from the simulator host to this machine (like adb reverse), so dev server URLs that use 127.0.0.1 work. On
      Android, such an entry also covers 10.0.2.2 on the same port. Requires --egress local.

--expo-go
      Install and launch Expo Go matching the current project's Expo SDK before the simulator session is ready.

--[no-]force
      [default: true] Create a new simulator session even when an existing simulator session is present in the
      environment.

--frame-ancestor=<value>...
      Origin of a page that may embed the simulator preview in a frame, such as https://app.example.com or
      https://*.example.com. Repeat for multiple origins. The embedding page loads the printed preview URL, which carries
      the session token, so anyone who can read that page can also control the simulator.

--json
      Enable JSON output, non-JSON messages will be printed to stderr. Implies --non-interactive.

--launch-arg=<value>...
      Argument passed to the installed application when it launches. Repeat for multiple arguments.

--max-duration-minutes=<value>
      Maximum duration of the simulator session in minutes before it is automatically stopped. Defaults to, and cannot
      exceed, the maximum session duration of the account's plan.

--max-idle-time-minutes=<value>
      Stop the simulator session automatically after this many minutes without session activity. When omitted, the session
      has no idle timeout and runs until its maximum duration.

--name=<value>
      Human-readable name for the simulator session, shown in eas simulator:list and on expo.dev. Defaults to unnamed.

--network-capture
      Record HTTP(S) traffic from apps on the device (iOS only). HTTPS is decrypted, so recordings contain credentials in
      cleartext and certificate-pinned apps fail to connect.

--network-capture-field=<value>...
      What a recording may keep beyond method, URL, status, timing and size: header, query, request-body, response-body.
      Repeatable or comma-separated. Defaults to none of them, because each can carry credentials.

--non-interactive
      Run the command in non-interactive mode.

--open-url=<value>
      Expo or development-client URL to open in the installed application after it launches.

--out-config-type=<option>
      [default: dotenv] How to output simulator connection configuration. Use "env" to print shell exports, or "dotenv" to
      write .env.eas-simulator.
      <options: env|dotenv>

--package-version=<value>
      Version of the package backing the simulator session (e.g. "0.1.3-alpha.3"). Defaults to "latest" when omitted.

--public-link
      Enable the simulator preview Share button and print a shareable link containing an access token. Anyone with the
      link can control the simulator. With --json, include previewApiUrl and its token for API clients when available.

--sdk-version=<value>
      Expo SDK version used to select Expo Go when --expo-go is passed. Defaults to the current project SDK.

--system-image=<value>
      Android SDK system image package to use for the emulator (e.g.
      "system-images;android-35-ext15;google_apis_playstore;x86_64"). Defaults to a system image chosen by the runner.
      Only supported with --platform android.

--tag=<value>...
      Label used to group simulator sessions, for example one per app variant. Repeat for multiple tags. Stored
      lowercased.

--type=<option>
      [default: agent-device] Type of simulator session to create. All session types include a web preview. agent-device,
      appium, and argent also include an automation interface; web-preview-only includes no automation interface.
      <options: agent-device|appium|argent|web-preview-only>

DESCRIPTION
  [EXPERIMENTAL] start a remote simulator session on EAS and get instructions to connect to it. The default browser
  preview link requires sign-in

ALIASES
  $ eas simulator:start
  $ eas sim:start
```

## `eas sim:stop`

[EXPERIMENTAL] stop a remote simulator session on EAS by its simulator session ID

```
USAGE
  $ eas sim:stop [--id <value>] [--json] [--non-interactive]

DESCRIPTION
  [EXPERIMENTAL] stop a remote simulator session on EAS by its simulator session ID

ALIASES
  $ eas sim:stop
```

## `eas simulator`

[EXPERIMENTAL] start a remote simulator session on EAS and get instructions to connect to it. The default browser preview link requires sign-in

```
USAGE
  $ eas simulator [-p android|ios] [--name <value>] [--tag <value>...] [--device <value>] [--system-image
    <value>] [--build-id <value> | --build-fingerprint <value> | --application-archive-url <value> | --expo-go]
    [--sdk-version <value>] [--launch-arg <value>...] [--open-url <value>] [--type
    agent-device|appium|argent|web-preview-only] [--package-version <value>] [--network-capture-field <value>...
    --network-capture] [--max-duration-minutes <value>] [--max-idle-time-minutes <value>] [--egress-allow <value>...
    --egress local] [--cors-origin <value>...] [--frame-ancestor <value>...] [--force] [--out-config-type env|dotenv]
    [--public-link] [--json] [--non-interactive]