# airbyte-cloud-cli

Standalone CLI for Airbyte Cloud operations.

```bash
pipx run airbyte-cloud-cli --help
```

## Install with Homebrew

Airbyte employees can install the CLI from the private internal tap:

```bash
brew install airbytehq/tap-internal/airbyte-cloud-cli
```

Configure Airbyte Cloud API credentials with environment variables. The
`AIRBYTE_CLOUD_API_URL` value below uses the public Airbyte Cloud API endpoint.

```bash
export AIRBYTE_CLOUD_CLIENT_ID="..."
export AIRBYTE_CLOUD_CLIENT_SECRET="..."
export AIRBYTE_CLOUD_WORKSPACE_ID="..."
export AIRBYTE_CLOUD_API_URL="https://api.airbyte.com/v1"
```

Confirm the CLI is installed and can authenticate with read-only commands:

```bash
airbyte-cloud --version
airbyte-cloud destinations list
airbyte-cloud destinations describe <destination-id>
```

Use a `destination_id` returned by `airbyte-cloud destinations list` for the
`describe` command. These commands read existing destination metadata and do not
create, update, delete, or trigger syncs.

For local development, run the workspace entrypoint from the repository root:

```bash
uv run airbyte-cloud --help
```
