CLI Reference

The ae CLI lets you discover, explore, and call APIs directly from your terminal. It provides a seamless way to interact with the ae.app marketplace without leaving your development environment.

Installation

Install the CLI using our installation script:

curl -fsSL https://ae.app/install.sh | sh

Verify the installation:

ae --version

Commands

ae auth

Manage your authentication state. The CLI uses a secure device flow to link with your ae.app account.

ae auth login    # Authenticate via device flow
ae auth logout   # Clear stored credentials
ae auth refresh  # Refresh authentication token
ae auth status   # Show current authentication state

ae search

Find providers and APIs in the marketplace. You can filter by tags, authentication types, and health status.

# Search for weather APIs
ae search weather

# Filter by auth type and sort by reliability
ae search email --auth api_key --sort reliable

ae @provider

View detailed information about a specific provider, including their available APIs and overall health status.

ae @open-meteo

ae @provider/api

Explore a specific API's documentation, including available endpoints, required parameters, and authentication requirements.

ae @open-meteo/forecast

ae @provider/api <method> <path>

Call an API endpoint directly from the CLI. Parameters can be passed as flags.

# Make a GET request to a specific endpoint
ae @open-meteo/forecast get /v1/forecast --latitude 40.71 --longitude -74.00

Global Flags

These flags are available across most commands to modify output and behavior:

Environment Variables

Override configuration or provide credentials using environment variables:

export AE_API_KEY="ae_live_..."    # Authenticate using an API key directly
export AE_API_URL="https://..."    # Override the default API base URL