Warp CLI

Ship Freight from Your Terminal

The Warp CLI turns freight operations into shell commands. Quote, book, track, and manage shipments without leaving your terminal. Built for developers. Designed for AI agents.

CLI Docs API Docs

Shell commands · Parseable output · AI agent ready · 20,000+ carriers

Shell nativefreight as commands

Parseablestructured output

AI readybuilt for agents

Why a freight CLI?

Every developer tool has a CLI. AWS has aws. Stripe has stripe. Heroku has heroku. Freight has had nothing. You want to check a rate? Open a portal. Book a load? Call someone. Track a shipment? Log into another portal. The Warp CLI brings freight into your terminal where the rest of your tools live.

The CLI wraps Warp's entire freight API. Every operation available through the REST API is available as a shell command. warp quote gets a rate. warp book creates a shipment. warp track shows you where it is. warp shipments lists everything you have in flight. The output is structured and machine readable.

This matters most for AI agents. Claude Code, Cursor, and other AI coding tools run in terminal environments. They can execute shell commands directly. An AI agent that needs to ship freight can call warp quote and warp book without writing any HTTP client code. The CLI handles authentication, request formatting, and response parsing.

Core commands

warp quote

$ warp quote \
    --origin 90210 \
    --dest 10001 \
    --pallets 4 \
    --weight 2400

  Mode          Rate        Transit    Quote ID
  LTL           $847.00     3 days     qt_01HGA2K9MN...
  Box Truck     $1,290.00   2 days     qt_01HGB3L0PQ...
  Cargo Van     $590.00     1 day      qt_01HGC4M1RS...

warp book

$ warp book qt_01HGA2K9MN... \
    --pickup-date 2026-04-07 \
    --pickup-contact "Warehouse Ops, 310-555-0100" \
    --pickup-address "123 Commerce Dr, Beverly Hills, CA 90210" \
    --delivery-contact "DC Receiving, 212-555-0200" \
    --delivery-address "456 Distribution Ave, New York, NY 10001"

  Booked: shp_01HGA2K9MNPQ4RV8XW3YZ5TJ6
  Tracking: WARP1234567890
  Pickup: April 7, 2026 (Beverly Hills, CA)
  ETA: April 10, 2026 (New York, NY)
  Track: https://customer.wearewarp.com/public/tracking/WARP1234567890

warp track

$ warp track WARP1234567890

  Status:     In Transit
  Location:   Barstow, CA
  ETA:        April 10, 2026 2:00 PM

  Events:
  Apr 7  10:15 AM  PICKED_UP       Beverly Hills, CA
  Apr 7  02:30 PM  SCANNED_IN      LAX Cross-Dock
  Apr 7  06:42 PM  DEPARTED        LAX Cross-Dock
  Apr 8  08:42 AM  IN_TRANSIT      Barstow, CA

warp shipments

$ warp shipments --status active

  ID                              Status       Origin          Dest            ETA
  shp_01HGA2K9MNPQ...            In Transit   Beverly Hills   New York        Apr 10
  shp_01HGF5N2QR...              Confirmed    Atlanta         Chicago         Apr 11
  shp_01HGG6O3RS...              Picked Up    Houston         Dallas          Apr 8

AI agent workflows

Claude Code workflow

You: I need to ship those 8 pallets from our Atlanta warehouse to
     Chicago DC. Find the cheapest option under $1,500.

Claude Code: Running warp commands...

$ warp quote --origin 30301 --dest 60601 --pallets 8 --weight 4800

  Mode          Rate        Transit
  LTL           $1,247.00   2 days     ← Under budget
  Box Truck     $1,890.00   1 day      ← Over budget

LTL at $1,247 is within your $1,500 budget. Booking now.

$ warp book qt_01HGA... --pickup-date 2026-04-07 ...

Booked. Shipment shp_01HGA2K9...
Pickup: Monday April 7, Atlanta
ETA: Wednesday April 9, Chicago

Autonomous agent (cron job)

#!/bin/bash
# Daily: check for pending orders and ship them

for order in $(get_pending_orders); do
  quote=$(warp quote \
    --origin $(order_origin $order) \
    --dest $(order_dest $order) \
    --pallets $(order_pallets $order) \
    --json)

  cheapest=$(echo $quote | jq '.quotes | min_by(.rate) | .id')
  warp book $cheapest --pickup-date tomorrow
done

Install the Warp CLI

CLI Docs API Docs Get a Quote Talk to Warp

Output formats

The CLI supports multiple output formats for different use cases:

-Default: human readable table format, as shown in the examples above.
---json: structured JSON for scripting and piping to jq.
---csv: CSV for spreadsheet import.
---quiet: minimal output (just IDs) for scripting.

The network behind every command

-20,000+ local 3rd-party carriers dispatched through the Warp driver app.
-9,000+ box trucks and cargo vans.
-50+ Warp operated cross-dock facilities across 12 markets.
-Our AI backbone, Orbit, monitoring every shipment.
-All inclusive pricing. No fuel surcharges, no hidden fees.

Frequently asked questions

How do I install the Warp CLI?

Installation instructions are at developer.wearewarp.com/docs/cli. Works on macOS, Linux, and Windows (via WSL).

Can AI agents use the CLI without human supervision?

Yes. The CLI supports non-interactive mode with all parameters passed as flags. AI agents can execute commands, parse the output, and make decisions autonomously.

Does the CLI support all freight modes?

Yes. LTL, truckload, box truck (26 foot, liftgate equipped), and cargo van (cartons, cases, parcels, or up to 3 pallets).

How does authentication work?

Run warp auth with your API key once. The CLI stores it securely and uses it for all subsequent commands.

Is there a test mode?

Yes. Run warp config set mode test to use test mode. All commands work the same but no real carriers are dispatched.

Ship with Claude CodeFreight via AI coding tools AI Freight AgentBuild autonomous freight agents Freight API TutorialREST API quickstart

Freight belongs in the terminal.

The Warp CLI gives developers and AI agents direct access to 20,000+ carriers, 50+ cross docks, and all inclusive pricing through shell commands. Quote, book, and track without leaving your workflow.