airport-cli

Put apps online from the command line with Airport.so.

A zero-dependency Node.js CLI that wraps the Airport.so REST API. Works great for humans and AI agents alike.

Install

npm install -g @provision-ai/airport-cli

Or run directly:

npx @provision-ai/airport-cli connect --port 3000

Requires Node.js 18+ and cloudflared for connections.

Quick start

# 1. Register (you'll get an email to verify)
airport register --email [email protected]

# 2. Start your app on any port, then connect it
airport connect --port 3000

# → Your app is live at https://cool-wave-4821.airport.so

Commands

Connect — Instant public URLs

airport connect --port <port> [--slug <slug>]

Make a locally running app public instantly. Your app gets a URL like https://my-app.airport.so.

# Connect port 3000 with auto-generated slug
airport connect --port 3000

# Connect with a custom slug
airport connect --port 8080 --slug my-api

The connection stays live as long as the CLI is running. Press Ctrl+C to disconnect.

Requirements: cloudflared must be installed.

airport connections

List all your active connections.

airport connections

airport disconnect

Remove the active connection created by airport connect.

airport disconnect

Deploy — Permanent hosting

airport deploy [dir] [--name <name>] [--slug <slug>]

Bundle and deploy a project permanently.

# Deploy current directory
airport deploy

# Deploy a specific directory with a custom name
airport deploy ./my-site --name "My Site"

airport projects

List all your projects.

airport status <slug>

Show the latest deploy status.

airport logs <slug>

Print the build log for the latest deploy.

Account

airport register --email <email>

Create an account and save your API key locally.

airport register --email [email protected]

airport whoami

Show your account info.

airport logout

Remove saved credentials.

Configuration

The CLI stores its config at ~/.airport/config.json:

{
  "api_key": "sk_live_...",
  "email": "[email protected]"
}

Debugging

Set DEBUG=1 to see full error stack traces:

DEBUG=1 airport connect --port 3000

License

MIT