eas-cli

EAS command line tool


- Installation
- Usage
- Commands

Installation

``sh
npm install -g eas-cli


or


yarn global add eas-cli
`

Enforcing eas-cli version for your project

If you want to enforce the eas-cli version for your project, use the "cli.version" field in eas.json. Installing eas-cli to your project dependencies is strongly discouraged because it may cause dependency conflicts that are difficult to debug.

An example of eas.json that enforces eas-cli in version 1.0.0 or newer:

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

Learn more: https://docs.expo.dev/build/eas-json/

Usage

`sh
eas COMMAND


runs the command

eas (-v|--version|version)

prints the version

eas --help COMMAND

outputs help for specific command

`

Commands


* eas account:login
* eas account:logout
* [eas account:usage [ACCOUNT_NAME]](#eas-accountusage-account_name)
* eas account:view
* [eas analytics [STATUS]](#eas-analytics-status)
* [eas autocomplete [SHELL]](#eas-autocomplete-shell)
* [eas branch:create [NAME]](#eas-branchcreate-name)
* [eas branch:delete [NAME]](#eas-branchdelete-name)
* eas branch:list
* eas branch:rename
* [eas branch:view [NAME]](#eas-branchview-name)
* eas build
* [eas build:cancel [BUILD_ID]](#eas-buildcancel-build_id)
* eas build:configure
* [eas build:delete [BUILD_ID]](#eas-builddelete-build_id)
* eas build:dev
* eas build:download
* eas build:inspect
* eas build:list
* eas build:resign
* eas build:run
* eas build:submit
* eas build:version:get
* eas build:version:set
* eas build:version:sync
* [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:list
* [eas channel:pause [NAME]](#eas-channelpause-name)
* [eas channel:resume [NAME]](#eas-channelresume-name)
* [eas channel:rollout [CHANNEL]](#eas-channelrollout-channel)
* [eas channel:view [NAME]](#eas-channelview-name)
* eas config
* eas credentials
* eas credentials:configure-build
* [eas deploy [options]](#eas-deploy-options)
* eas deploy:alias
* [eas deploy:alias:delete [ALIAS_NAME]](#eas-deployaliasdelete-alias_name)
* [eas deploy:delete [DEPLOYMENT_ID]](#eas-deploydelete-deployment_id)
* eas deploy:promote
* eas device:create
* eas device:delete
* eas device:list
* eas device:rename
* [eas device:view [UDID]](#eas-deviceview-udid)
* eas diagnostics
* [eas env:create [ENVIRONMENT]](#eas-envcreate-environment)
* [eas env:delete [ENVIRONMENT]](#eas-envdelete-environment)
* eas env:exec 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:update [ENVIRONMENT]](#eas-envupdate-environment)
* [eas fingerprint:compare [HASH1] [HASH2]](#eas-fingerprintcompare-hash1-hash2)
* eas fingerprint:generate
* [eas help [COMMAND]](#eas-help-command)
* eas init
* [eas init:onboarding [TARGET_PROJECT_DIRECTORY]](#eas-initonboarding-target_project_directory)
* eas login
* eas logout
* eas metadata:lint
* eas metadata:pull
* eas metadata:push
* [eas new [PATH]](#eas-new-path)
* [eas onboarding [TARGET_PROJECT_DIRECTORY]](#eas-onboarding-target_project_directory)
* eas open
* eas project:info
* eas project:init
* [eas project:new [PATH]](#eas-projectnew-path)
* [eas project:onboarding [TARGET_PROJECT_DIRECTORY]](#eas-projectonboarding-target_project_directory)
* eas submit
* eas update
* eas update:configure
* eas update:delete GROUPID
* [eas update:edit [GROUPID]](#eas-updateedit-groupid)
* eas update:list
* eas update:republish
* eas update:revert-update-rollout
* eas update:roll-back-to-embedded
* eas update:rollback
* eas update:view GROUPID
* eas upload
* eas webhook:create
* [eas webhook:delete [ID]](#eas-webhookdelete-id)
* eas webhook:list
* eas webhook:update
* eas webhook:view ID
* eas whoami
* eas worker:alias
* [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-1)
* eas workflow:cancel
* [eas workflow:create [NAME]](#eas-workflowcreate-name)
* [eas workflow:logs [ID]](#eas-workflowlogs-id)
* [eas workflow:run [FILE]](#eas-workflowrun-file)
* eas workflow:runs
* [eas workflow:status [WORKFLOW_RUN_ID]](#eas-workflowstatus-workflow_run_id)
* eas workflow:validate PATH
* [eas workflow:view [ID]](#eas-workflowview-id)

eas account:login

log in with your Expo account

`
USAGE
$ eas account:login [-s]

FLAGS
-s, --sso Login with SSO

DESCRIPTION
log in with your Expo account

ALIASES
$ eas login
`

_See code: 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_

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_

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_

eas analytics [STATUS]

display or change analytics settings

`
USAGE
$ eas analytics [STATUS]

DESCRIPTION
display or change analytics settings
`

_See code: 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_

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.
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
create a branch
`

_See code: 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.
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
delete a branch
`

_See code: packages/eas-cli/src/commands/branch/delete.ts_

eas branch:list

list all branches

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

FLAGS
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= 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_

eas branch:rename

rename a branch

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

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

DESCRIPTION
rename a branch
`

_See code: packages/eas-cli/src/commands/branch/rename.ts_

eas branch:view [NAME]

view a branch

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

ARGUMENTS
NAME Name of the branch to view

FLAGS
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= 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_

eas build

start a build

`
USAGE
$ eas build [-p android|ios|all] [-e ] [--local] [--output ] [--wait] [--clear-cache] [-s |
--auto-submit-with-profile ] [--what-to-test ] [-m ] [--build-logger-level
trace|debug|info|warn|error|fatal] [--freeze-credentials] [--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= A short message describing the build
-p, --platform=(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=(trace|debug|info|warn|error|fatal) The level of logs to output during the build process.
Defaults to "info".
--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.
--local Run build locally [experimental]
--non-interactive Run the command in non-interactive mode.
--output= Output path for local build
--verbose-logs Use verbose logs for the build process
--[no-]wait Wait for build(s) to complete
--what-to-test= 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_

eas build:cancel [BUILD_ID]

cancel a build

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

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

DESCRIPTION
cancel a build
`

_See code: 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=(android|ios|all) Platform to configure

DESCRIPTION
configure the project to support EAS Build
`

_See code: 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 ]

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

DESCRIPTION
delete a build
`

_See code: 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 ]

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=(ios|android)

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_

eas build:download

download simulator/emulator builds for a given fingerprint hash

`
USAGE
$ eas build:download --fingerprint [-p ios|android] [--dev-client] [--json --non-interactive]

FLAGS
-p, --platform=(ios|android)
--[no-]dev-client Filter only dev-client builds.
--fingerprint= (required) Fingerprint hash of the build to download
--json Enable JSON output, non-JSON messages will be printed to stderr.
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
download simulator/emulator builds for a given fingerprint hash
`

_See code: 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 [-e ] [--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=(android|ios)
(required)

-s, --stage=(archive|pre-build|post-build)
(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

-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_

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 ] [--app-version ] [--app-build-version ] [--sdk-version ] [--runtime-version
] [--app-identifier ] [-e ] [--git-commit-hash ] [--fingerprint-hash ] [--offset
] [--limit ] [--json --non-interactive] [--simulator]

FLAGS
-e, --build-profile= Filter only builds created with the
specified build profile
-p, --platform=(android|ios|all)
--app-build-version= Filter only builds created with the
specified app build version
--app-identifier= Filter only builds created with the
specified app identifier
--app-version= Filter only builds created with the
specified main app version
--channel=
--distribution=(store|internal|simulator) Filter only builds with the specified
distribution type
--fingerprint-hash= Filter only builds with the specified
fingerprint hash
--git-commit-hash= Filter only builds created with the
specified git commit hash
--json Enable JSON output, non-JSON messages
will be printed to stderr.
--limit= 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= Start queries from specified index. Use
for paginating results. Defaults to 0.
--runtime-version= Filter only builds created with the
specified runtime version
--sdk-version= 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=(new|in-queue|in-progress|pending-cancel|errored|finished|canceled) Filter only builds with the specified
status

DESCRIPTION
list all builds for your project
`

_See code: packages/eas-cli/src/commands/build/list.ts_

eas build:resign

re-sign a build archive

`
USAGE
$ eas build:resign [-p android|ios] [-e ] [--source-profile ] [--wait] [--id ] [--offset
] [--limit ] [--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=(android|ios)
--id= ID of the build to re-sign.
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= 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_

eas build:run

run simulator/emulator builds from eas-cli

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

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=(android|ios)
--id= ID of the simulator/emulator build to run
--latest Run the latest simulator/emulator build for specified platform
--limit= The number of items to fetch each query. Defaults to 50 and is capped at 100.
--offset= Start queries from specified index. Use for paginating results. Defaults to 0.
--path= Path to the simulator/emulator build archive or app
--url= Simulator/Emulator build archive url

DESCRIPTION
run simulator/emulator builds from eas-cli
`

_See code: 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 ] [--latest | --id | --path | --url ]
[--what-to-test ] [--verbose] [--wait] [--verbose-fastlane] [-g ] [--non-interactive]

FLAGS
-e, --profile= Name of the submit profile from eas.json. Defaults to "production" if defined in
eas.json.
-g, --groups=... 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=(android|ios|all)
--id= ID of the build to submit
--latest Submit the latest build for specified platform
--non-interactive Run command in non-interactive mode
--path= Path to the .apk/.aab/.ipa file
--url= 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= 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 ] [--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=(android|ios|all)
--json Enable JSON output, non-JSON messages will be printed to stderr.
--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_

eas build:version:set

update version of an app

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

FLAGS
-e, --profile=PROFILE_NAME Name of the build profile from eas.json. Defaults to "production" if defined in
eas.json.
-p, --platform=(android|ios)

DESCRIPTION
update version of an app
`

_See code: 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 ]

FLAGS
-e, --profile=PROFILE_NAME Name of the build profile from eas.json. Defaults to "production" if defined in
eas.json.
-p, --platform=(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_

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_

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.
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
create a channel
`

_See code: 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.
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
Delete a channel
`

_See code: 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 ] [--json --non-interactive]

ARGUMENTS
NAME Name of the channel to edit

FLAGS
--branch= Name of the branch to point to
--json Enable JSON output, non-JSON messages will be printed to stderr.
--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_

eas channel:list

list all channels

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

FLAGS
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= 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_

eas channel:pause [NAME]

pause a channel to stop it from sending updates

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

ARGUMENTS
NAME Name of the channel to edit

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

DESCRIPTION
pause a channel to stop it from sending updates
`

_See code: packages/eas-cli/src/commands/channel/pause.ts_

eas channel:resume [NAME]

resume a channel to start sending updates

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

ARGUMENTS
NAME Name of the channel to edit

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

DESCRIPTION
resume a channel to start sending updates
`

_See code: 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 ] [--outcome
republish-and-revert|revert] [--branch ] [--runtime-version ] [--private-key-path ] [--json
--non-interactive]

ARGUMENTS
CHANNEL channel on which the rollout should be done

FLAGS
--action=(create|edit|end|view) Rollout action to perform
--branch= Branch to roll out. Use with --action=create
--json Enable JSON output, non-JSON messages will be printed to stderr.
--non-interactive Run the command in non-interactive mode.
--outcome=(republish-and-revert|revert) End outcome of rollout. Use with --action=end
--percent= Percent of users to send to the new branch. Use with --action=edit or
--action=create
--private-key-path= 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= 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_

eas channel:view [NAME]

view a channel

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

ARGUMENTS
NAME Name of the channel to view

FLAGS
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= Start queries from specified index. Use for paginating results. Defaults to 0.

DESCRIPTION
view a channel
`

_See code: packages/eas-cli/src/commands/channel/view.ts_

eas config

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

`
USAGE
$ eas config [-p android|ios] [-e ] [--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=(android|ios)
--json Enable JSON output, non-JSON messages will be printed to stderr.
--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_

eas credentials

manage credentials

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

FLAGS
-p, --platform=(android|ios)

DESCRIPTION
manage credentials
`

_See code: 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 ]

FLAGS
-e, --profile=PROFILE_NAME The name of the build profile in eas.json.
-p, --platform=(android|ios)

DESCRIPTION
Set up credentials for building your project.
`

_See code: 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

FLAGS
--alias=name Custom alias to assign to the new deployment.
--dry-run Outputs a tarball of the new deployment instead of uploading it.
--environment= 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.
--non-interactive Run the command in non-interactive mode.
--prod Create a new production 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_

eas deploy:alias

Assign deployment aliases.

`
USAGE
$ eas deploy:alias [--prod] [--alias ] [--id ] [--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.
--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_

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.
--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_

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.
--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_

eas deploy:promote

Assign deployment aliases.

`
USAGE
$ eas deploy:promote [--prod] [--alias ] [--id ] [--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.
--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
`

eas device:create

register new Apple Devices to use for internal distribution

`
USAGE
$ eas device:create

DESCRIPTION
register new Apple Devices to use for internal distribution
`

_See code: 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 ] [--udid ] [--json --non-interactive]

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

DESCRIPTION
remove a registered device from your account
`

_See code: 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 ] [--offset ] [--limit ] [--json --non-interactive]

FLAGS
--apple-team-id=
--json Enable JSON output, non-JSON messages will be printed to stderr.
--limit= 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= 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_

eas device:rename

rename a registered device

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

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

DESCRIPTION
rename a registered device
`

_See code: 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_

eas diagnostics

display environment info

`
USAGE
$ eas diagnostics

DESCRIPTION
display environment info
`

_See code: packages/eas-cli/src/commands/diagnostics.ts_

eas env:create [ENVIRONMENT]

create an environment variable for the current project or account

`
USAGE
$ eas env:create [ENVIRONMENT] [--name ] [--value ] [--force] [--type string|file] [--visibility
plaintext|sensitive|secret] [--scope project|account] [--environment ] [--non-interactive]

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

FLAGS
--environment=... Environment variable's environment, e.g. 'production', 'preview',
'development'
--force Overwrite existing variable
--name= Name of the variable
--non-interactive Run the command in non-interactive mode.
--scope=(project|account) [default: project] Scope for the variable
--type=(string|file) The type of variable
--value= Text value or the variable
--visibility=(plaintext|sensitive|secret) Visibility of the variable

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

_See code: packages/eas-cli/src/commands/env/create.ts_

eas env:delete [ENVIRONMENT]

delete an environment variable for the current project or account

`
USAGE
$ eas env:delete [ENVIRONMENT] [--variable-name ] [--variable-environment ] [--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=(project|account) [default: project] Scope for the variable
--variable-environment= Current environment of the variable to delete
--variable-name= 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_

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_

eas env:get [ENVIRONMENT]

view an environment variable for the current project or account

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

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

FLAGS
--format=(long|short) [default: short] Output format
--non-interactive Run the command in non-interactive mode.
--scope=(project|account) [default: project] Scope for the variable
--variable-environment= Current environment of the variable
--variable-name= 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_

eas env:list [ENVIRONMENT]

list environment variables for the current project or account

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

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

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

DESCRIPTION
list environment variables for the current project or account
`

_See code: 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 ] [--path ]

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

FLAGS
--environment= Environment variable's environment, e.g. 'production', 'preview', 'development'
--non-interactive Run the command in non-interactive mode.
--path= [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_

eas env:push [ENVIRONMENT]

push environment variables from .env file to the selected environment

`
USAGE
$ eas env:push [ENVIRONMENT] [--environment ] [--path ] [--force]

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

FLAGS
--environment=... Environment variable's environment, e.g. 'production', 'preview', 'development'
--force Skip confirmation and automatically override existing variables
--path= [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_

eas env:update [ENVIRONMENT]

update an environment variable on the current project or account

`
USAGE
$ eas env:update [ENVIRONMENT] [--variable-name ] [--variable-environment ] [--name ]
[--value ] [--type string|file] [--visibility plaintext|sensitive|secret] [--scope project|account]
[--environment ] [--non-interactive]

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

FLAGS
--environment=... Environment variable's environment, e.g. 'production', 'preview',
'development'
--name= New name of the variable
--non-interactive Run the command in non-interactive mode.
--scope=(project|account) [default: project] Scope for the variable
--type=(string|file) The type of variable
--value= New value or the variable
--variable-environment= Current environment of the variable to update
--variable-name= Current name of the variable
--visibility=(plaintext|sensitive|secret) Visibility of the variable

DESCRIPTION
update an environment variable on the current project or account
`

_See code: packages/eas-cli/src/commands/env/update.ts_

eas fingerprint:compare [HASH1] [HASH2]

compare fingerprints of the current project, builds, and updates

`
USAGE
$ eas fingerprint:compare [HASH1] [HASH2] [--build-id ] [--update-id ] [--open] [--environment ]
[--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=... Compare the fingerprint with the build with the specified ID
--environment= If generating a fingerprint from the local directory, use the specified environment.
--json Enable JSON output, non-JSON messages will be printed to stderr.
--non-interactive Run the command in non-interactive mode.
--open Open the fingerprint comparison in the browser
--update-id=... 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 # Compare fingerprint against local directory

$ eas fingerprint:compare # Compare provided fingerprints

$ eas fingerprint:compare --build-id # Compare fingerprint from build against local directory

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

$ eas fingerprint:compare --build-id --build-id # Compare fingerprint from a build against another build

$ eas fingerprint:compare --build-id --update-id # Compare fingerprint from build against fingerprint from update

$ eas fingerprint:compare --update-id # Compare fingerprint from update against provided fingerprint
`

_See code: 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 | -e ] [--json --non-interactive]

FLAGS
-e, --build-profile= Name of the build profile from eas.json.
-p, --platform=(android|ios)
--environment= Environment variable's environment, e.g. 'production', 'preview', 'development'
--json Enable JSON output, non-JSON messages will be printed to stderr.
--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_

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_

eas init

create or link an EAS project

`
USAGE
$ eas init [--id ] [--force] [--non-interactive]

FLAGS
--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
--id= ID of the EAS project to link
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
create or link an EAS project

ALIASES
$ eas init
`

eas init:onboarding [TARGET_PROJECT_DIRECTORY]

continue onboarding process started on the https://expo.new website.

`
USAGE
$ eas init:onboarding [TARGET_PROJECT_DIRECTORY]

DESCRIPTION
continue onboarding process started on the https://expo.new website.

ALIASES
$ eas init:onboarding
$ eas onboarding
`

eas login

log in with your Expo account

`
USAGE
$ eas login [-s]

FLAGS
-s, --sso Login with SSO

DESCRIPTION
log in with your Expo account

ALIASES
$ eas login
`

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 ]

FLAGS
--json Enable JSON output, non-JSON messages will be printed to stderr
--profile= 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_

eas metadata:pull

generate the local store configuration from the app stores

`
USAGE
$ eas metadata:pull [-e ]

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

DESCRIPTION
generate the local store configuration from the app stores
`

_See code: 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 ]

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

DESCRIPTION
sync the local store configuration to the app stores
`

_See code: 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]

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

FLAGS
-p, --package-manager=(bun|npm|pnpm|yarn) [default: npm] Package manager to use for installing dependencies

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

ALIASES
$ eas new
`

eas onboarding [TARGET_PROJECT_DIRECTORY]

continue onboarding process started on the https://expo.new website.

`
USAGE
$ eas onboarding [TARGET_PROJECT_DIRECTORY]

DESCRIPTION
continue onboarding process started on the https://expo.new website.

ALIASES
$ eas init:onboarding
$ eas onboarding
`

eas open

open the project page in a web browser

`
USAGE
$ eas open

DESCRIPTION
open the project page in a web browser
`

_See code: packages/eas-cli/src/commands/open.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_

eas project:init

create or link an EAS project

`
USAGE
$ eas project:init [--id ] [--force] [--non-interactive]

FLAGS
--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
--id= ID of the EAS project to link
--non-interactive Run the command in non-interactive mode.

DESCRIPTION
create or link an EAS project

ALIASES
$ eas init
`

_See code: 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]

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

FLAGS
-p, --package-manager=(bun|npm|pnpm|yarn) [default: npm] Package manager to use for installing dependencies

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

ALIASES
$ eas new
`

_See code: packages/eas-cli/src/commands/project/new.ts_

eas project:onboarding [TARGET_PROJECT_DIRECTORY]

continue onboarding process started on the https://expo.new website.

`
USAGE
$ eas project:onboarding [TARGET_PROJECT_DIRECTORY]

DESCRIPTION
continue onboarding process started on the https://expo.new website.

ALIASES
$ eas init:onboarding
$ eas onboarding
`

_See code: packages/eas-cli/src/commands/project/onboarding.ts_

eas submit

submit app binary to App Store and/or Play Store

`
USAGE
$ eas submit [-p android|ios|all] [-e ] [--latest | --id | --path | --url ]
[--what-to-test ] [--verbose] [--wait] [--verbose-fastlane] [-g ] [--non-interactive]

FLAGS
-e, --profile= Name of the submit profile from eas.json. Defaults to "production" if defined in
eas.json.
-g, --groups=... 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=(android|ios|all)
--id= ID of the build to submit
--latest Submit the latest build for specified platform
--non-interactive Run command in non-interactive mode
--path= Path to the .apk/.aab/.ipa file
--url= 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= 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
`

_See code: packages/eas-cli/src/commands/submit.ts_

eas update

publish an update group

``
USAGE
$ eas update [--branch ] [--channel ] [-m ] [--input-dir ] [--skip-bundler]
[--clear-cache] [--emit-metadata] [--rollout-percentage ] [-p android|ios|all] [--auto] [--private-key-path
] [--environment ] [--json --non-interactive]

FLAGS
-m, --message= A short message describing the update
-p, --platform=(android|ios|all) [default: all]
--auto Use the current git branch and commit message for the EAS branch and update message
--branch= Branch to publish the update group on
--channel= Channel that the published update should affect
--clear-cache Clear the bundler cache before publishing
--emit-metadata Emit "eas-update-metadata.json" in the bundle folder with detailed information about
the generated updates
--environment= Environment to use for the server-side defined EAS environment variables during
command execution, e.g. "production", "preview", "development"
--input-dir= [default: dist] Location of the bundle
--json Enable JSON output, non-JSON messages will be printed to stderr.
--non-interactive Run the command in non-interactive mode.
--private-key-path=