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 Quickstart 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-agent ltl quote gets a rate. warp-agent book creates a shipment. warp-agent track shows you where it is. warp-agent bookings 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-agent ltl quote and warp-agent book without writing any HTTP client code. The CLI handles authentication, request formatting, and response parsing.

Core commands

warp-agent ltl quote

$ warp-agent ltl quote 90210 10001 \
    --pallets 4 --weight 600 --dims 48x40x48 --date 2026-05-01

{
  "warp_quote_id": "PRICING_abc-123",
  "warp_price": 955.93,
  "transit_days": 5,
  "options": [
    { "carrier": "Warp Technology", "rate": 955.93, "transit_days": 5, "option_id": "PRICING_abc-123" },
    { "carrier": "GlovaLink",       "rate": 598.54, "transit_days": 8, "option_id": "OPT_..." },
    { "carrier": "Forward",         "rate": 799.30, "transit_days": 5, "option_id": "OPT_..." }
  ]
}

warp-agent book

$ warp-agent book PRICING_abc-123 \
    --pickup-company "Acme" --pickup-street "123 Commerce Dr" \
    --pickup-city "Beverly Hills" --pickup-state "CA" --pickup-zip "90210" \
    --pickup-contact "Ops" --pickup-phone "3105550100" --pickup-email "ops@acme.com" \
    --delivery-company "DC" --delivery-street "456 Distribution Ave" \
    --delivery-city "New York" --delivery-state "NY" --delivery-zip "10001" \
    --delivery-contact "Receiving" --delivery-phone "2125550200" --delivery-email "rx@dc.com"

{
  "trackingNumber": "S-80215-2616",
  "orderNumber": "ORD-12345",
  "orderId": "ord_abc",
  "shipmentId": "shp_xyz",
  "pickup_date": "2026-05-01"
}

warp-agent track

$ warp-agent track S-80215-2616

{
  "status": "IN_TRANSIT",
  "location": "Barstow, CA",
  "eta": "2026-05-03T14:00:00Z",
  "last_event": {
    "type": "DEPARTED",
    "location": "LAX Cross-Dock",
    "timestamp": "2026-05-01T18:42:00Z"
  }
}

$ warp-agent events S-80215-2616
# full event history as an array

warp-agent bookings

$ warp-agent bookings --limit 5

[
  { "trackingNumber": "S-80215-2616", "status": "IN_TRANSIT", "origin": "Beverly Hills", "dest": "New York", "eta": "2026-05-03" },
  { "trackingNumber": "S-80216-4401", "status": "CONFIRMED",  "origin": "Atlanta",       "dest": "Chicago",  "eta": "2026-05-04" },
  { "trackingNumber": "S-80217-8812", "status": "PICKED_UP",  "origin": "Houston",       "dest": "Dallas",   "eta": "2026-05-02" }
]

AI agent workflows

Claude Code workflow

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

Claude Code:

$ warp-agent ltl quote 30301 60601 --pallets 8 --weight 800 --dims 48x40x48 --date 2026-05-07

Returns Warp at $1,247 and 20+ market carriers. Filters for rate < 1500,
picks lowest-price: GlovaLink at $898 (8-day transit, option_id OPT_xyz).

$ warp-agent book OPT_xyz [address flags]

Booked. Tracking: S-80215-2616
Pickup: Monday May 7, Atlanta
ETA:    Tuesday May 15, Chicago

Autonomous agent (cron job)

#!/bin/bash
# Daily: quote pending orders, book under-budget ones

for order in $(get_pending_orders); do
  quote=$(warp-agent ltl quote \
    "$(order_origin $order)" "$(order_dest $order)" \
    --pallets "$(order_pallets $order)" --weight "$(order_weight $order)" \
    --dims "$(order_dims $order)" --date "$(order_date $order)")

  cheapest_id=$(echo "$quote" | jq -r '.options | min_by(.rate) | .option_id')
  cheapest_rate=$(echo "$quote" | jq '.options | min_by(.rate) | .rate')

  warp-agent book "$cheapest_id" $(order_address_flags $order) \
    | jq -r '.trackingNumber' \
    | tee -a booked.log
done

Install the Warp CLI

CLI Quickstart API Docs Get LTL & FTL Rates 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 metros.
-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 Agent CLI?

Run npm install -g @warpfreight/cli-agent. Requires Node.js 18 or later. Works on macOS, Linux, and Windows. See /tools/cli for the full quickstart.

Can AI agents use the CLI without human supervision?

Yes. Every command takes all parameters as flags and outputs clean JSON by default. After warp-agent login runs once on a trusted machine, the saved ~/.warp/config.json handles auth for every subsequent run -- no prompts, no keys in scripts.

Does the CLI support all freight modes?

Yes. LTL, full truckload (53-foot dry van), box truck (26-foot, up to 12 pallets), cargo van (1-3 pallets, up to 3,500 lbs), and multi-stop FTL (one truck, multiple pickups or deliveries).

How does authentication work?

Run warp-agent login once. It prompts for email and password, creates a Warp account if needed (self-provisioning), and saves the API key to ~/.warp/config.json. Every subsequent command reads from that file. No env vars, no flags, no keys in scripts.

Do quote commands need auth?

No. warp-agent ltl/van/box-truck/ftl quote are all public and work without logging in. Only booking, tracking, cancel, documents, and other account-scoped commands require warp-agent login first.

Ship with Claude CodeFreight via AI coding tools AI Freight AgentBuild autonomous freight agents Freight API TutorialREST API quickstart AI HubAll AI freight capabilities Developer HubAPI docs, SDKs, and guides MCP vs CLI for FreightCompare agent integration paths What Is Agentic AI in Freight?Autonomous action, not just alerts Set Up Your First AI AgentNo code required guide

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.