Airplane CLI

The Airplane CLI, airplane, is the primary way you'll create and deploy new tasks. The CLI also provides utility methods for getting/setting configs, executing tasks, viewing runs, etc...

Installing the CLI

If you use Homebrew, you can install the CLI by running:
bash
Copied
1
brew install airplanedev/tap/airplane
Otherwise, you can install with our installation script:
bash
Copied
1
curl -L https://github.com/airplanedev/cli/releases/latest/download/install.sh | sh

Authentication

You can log in to the CLI by running airplane login. This will open a browser window to complete authentication—you can close the window when you're done.
bash
Copied
1
airplane login
2
# If you want to change teams or log out: airplane logout
If instead you want to authenticate on behalf of a service account, perhaps to use the CLI in automation, you can set the AP_API_KEY and AP_TEAM_ID environment variables to the API key and team id of the service account:
bash
Copied
1
export AP_API_KEY=<your_api_key>
2
export AP_TEAM_ID=<your_team_id>
3
# deploy is run on behalf of the service account
4
airplane deploy ./path/to/tasks --yes
To confirm you're logged in, you can run airplane auth info:
bash
Copied
1
airplane auth info
2
Signed in as youremail@example.com
3
Using team MyTeam (ID: 1rGi5xu8bPuxT8TV0KKwP10RQuD)

Updating the CLI

To update the CLI, run the following:
bash
Copied
1
airplane update
The airplane update command was added in v0.3.172 (August 9th, 2023). If you get an Unknown command "update" for "airplane" error, you should upgrade the CLI by instead re-running the installation command.

Local development with Studio

The Airplane Studio provides a rich development experience that allows you to quickly iterate on Tasks and Views, even before they've been deployed. To manage code for tasks and views locally, we recommend using the Airplane CLI to start Studio with a local development server.

Starting Studio

Airplane Studio can be started locally with airplane dev:
bash
Copied
1
$ airplane dev
2
Discovering tasks and views...registered 2 tasks and 1 view.
3
4
Started studio session at https://app.airplane.dev/studio?host=http://localhost:4000 (^C to quit)
5
Press ENTER to open the studio in the browser.
See Studio for more info.