Blacklane CLI

Upfront chauffeur quotes from the terminal — transfer and hourly, with a local price history no other tool has.

Quote Blacklane's fixed all-inclusive chauffeur fares (airport transfers and by-the-hour) by address, compare vehicle classes, and keep a searchable local log of every quote. Addresses resolve via OpenStreetMap — no API key, no login, no booking.

Created by @omarshahine (Omar Shahine).

Quick Start

# Point-to-point transfer quote across vehicle classes.
blacklane-pp-cli quote "San Francisco Airport" "Union Square San Francisco" --at 2026-06-25T15:00

# By-the-hour chauffeur quote (3 hours).
blacklane-pp-cli quote "Union Square San Francisco" --hourly 3 --at 2026-06-25T15:00

# Inspect a vehicle class's models, capacity, and features.
blacklane-pp-cli catalog business

Unique Features

These capabilities aren't available in any other tool for this API.

Local state that compounds

• watch — Track a saved route's price over time and flag drops.

  Reach for this to catch chauffeur price drops before a trip.

  blacklane-pp-cli watch "San Francisco Airport" "Union Square San Francisco" --at 2026-06-25T15:00 --agent
  

• compare — Quote one route across many departure times to find the cheapest.

  Use when the pickup time is flexible and price matters.

  blacklane-pp-cli compare "JFK Airport" "Times Square New York" --dates 2026-06-20T15:00,2026-06-21T15:00 --agent
  

• log — Every quote saved to SQLite, full-text searchable and SQL-queryable.

  Use to recall and compare past quotes offline.

  blacklane-pp-cli search "Times Square" --agent
  

Trip planning

• trip — Quote a sequence of legs and total the fares.

  Use to budget a full day of ground transport.

  blacklane-pp-cli trip --leg "JFK Airport>Times Square New York" --at 2026-06-20T09:00 --agent
  

• fit — Recommend the cheapest vehicle class that fits the party.

  Use to avoid overpaying for more car than you need.

  blacklane-pp-cli fit "JFK Airport" "Times Square New York" --pax 3 --bags 4 --at 2026-06-20T15:00 --agent
  

Authenticated account

• bookings — List your upcoming and past Blacklane rides (requires auth login).

  Pull your ride history/status without opening the site.

  blacklane-pp-cli bookings --when upcoming --agent
  

• me — Show your Blacklane profile (requires auth login).

  Confirm which account the CLI is acting as.

  blacklane-pp-cli me --agent
  

• wallet — Show wallet credits and vouchers (requires auth login).

  Check available credits before booking.

  blacklane-pp-cli wallet --agent
  

Booking

• book — Quote and assemble a booking, then open browser checkout for payment under --confirm. Never charges.

  Assemble and price a ride in the terminal, confirm payment yourself in the browser.

  blacklane-pp-cli book 'JFK Airport' 'Times Square New York' --at 2026-06-25T15:00 --class business
  

Recipes

Quote and keep only class + price

blacklane-pp-cli quote "JFK Airport" "Times Square New York" --at 2026-06-20T15:00 --agent --select packages.title,packages.grossAmount,packages.currency

Narrow a verbose quote to just the class and total.

Find the cheapest departure

blacklane-pp-cli compare "JFK Airport" "Times Square New York" --dates 2026-06-20T15:00,2026-06-21T09:00,2026-06-22T09:00 --agent

Fan out quotes across times and rank by price.

Usage

Run blacklane-pp-cli --help for the full command reference and flag list.

Commands

catalog

Vehicle-class service catalog (models, capacity, features)

• blacklane-pp-cli catalog <slug> - Get a vehicle class by slug (business, first, van)

prices

Raw pricing quotes (prefer the top-level 'quote' command)

• blacklane-pp-cli prices - Request prices for a journey (raw body; see 'quote' for a friendly interface)

Output Formats

# Human-readable table (default in terminal, JSON when piped)
blacklane-pp-cli catalog mock-value

# JSON for scripting and agents
blacklane-pp-cli catalog mock-value --json

# Filter to specific fields
blacklane-pp-cli catalog mock-value --json --select id,name,status

# Dry run — show the request without sending
blacklane-pp-cli catalog mock-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
blacklane-pp-cli catalog mock-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Explicit retries - add --idempotent to create retries when a no-op success is acceptable
• Confirmable - --yes for explicit confirmation of destructive actions
• Piped input - write commands can accept structured input when their help lists --stdin
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

blacklane-pp-cli doctor

Verifies configuration and connectivity to the API.

Authentication

Quotes, catalog, and geocoding need no auth. The account commands and book use your own Blacklane login — easiest via Chrome:

blacklane-pp-cli auth login --chrome    # imports your 24h access token from Chrome (non-invasive)
# durable alternative: pbpaste | blacklane-pp-cli auth login   (refresh token from DevTools)

Credentials are stored owner-only at ~/.config/blacklane-pp-cli/auth.json. book never charges — payment (Braintree + 3-D Secure) is completed by you in the browser.

Configuration

Config file: ~/.config/blacklane-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

• Check the resource ID is correct
• Run the list command to see available items

API-specific

• Quote returns no vehicle classes — The route may be outside Blacklane's service area, or the date is in the past — try a major city/airport and a future time.
• Address resolves to the wrong place — Pass more specific text or use --pickup-lat/--pickup-lng (and --dropoff-lat/lng) to set coordinates directly.