Ship freight without leaving your terminal

@warpfreight/cli-agent, published to npm on April 16, 2026. The warp-agent binary lets terminal-native AI tools like Claude Code and Cursor (and any shell-driven agent orchestrator) quote, book, track, cancel, and manage LTL, FTL, box truck, and cargo van shipments through the Warp network. Sibling package warp-agent-mcp shipped the same day, making Warp the first freight network with both an MCP server and a CLI for AI agents.

April 16, 2026. The npm publish date for @warpfreight/cli-agent is the canonical timestamp. Verify at https://www.npmjs.com/package/@warpfreight/cli-agent.

Yes. Every warp-agent command hits the same /api/v1 endpoints the Warp customer portal uses. Same decision engine, same carriers, same all-inclusive pricing, same dispatch line, same Orbit exception handling. Bookings appear in customer.wearewarp.com automatically.

Quotes expire exactly 15 minutes after creation. The expires_at field in every quote response gives you the exact deadline. In CI pipelines, always quote and book in the same script run. If you need to inspect the quote first, check expires_at before calling book.

Dimensions must be LxWxH with a lowercase letter x as the separator -- for example 48x40x48. Spaces, commas, and uppercase X are not accepted. The three numbers are length, width, and height in inches.

Quote endpoints (van, box-truck, ftl, ltl) are public and don't require authentication. Every other command needs your saved API key. Run warp-agent login once -- it writes the key to ~/.warp/config.json and every subsequent command reads from there automatically. Run warp-agent whoami to confirm you're logged in.

The weight limit is on total shipment weight, not per pallet. Cargo vans max out at 3,500 lbs total (pallets times weight-per-pallet). Box trucks max at 10,000 lbs total. If you have 6 pallets at 800 lbs each, that is 4,800 lbs -- over the van limit but fine for a box truck.

An indicative quote means one or more fields are missing. Check the missing_for_ship array in the response -- it lists exactly which fields you need to add. Common missing fields are commodity, weight_lbs_per_pallet, and dimensions. Once you supply all of them, the quote will return as firm and be bookable.

ZIP codes must be exactly 5 digits with no spaces, dashes, or leading text. "90001" is valid. "90001-1234", " 90001", and "CA 90001" are not. The API validates with a strict 5-digit regex.

Cargo vans are regional vehicles. A van from LA to New York won't return a quote because that is not a viable van lane. Use box-truck for mid-range shipments or ftl for cross-country. If you are unsure which mode fits, start with ltl -- it covers the widest range of lanes.

Quoting only needs ZIP codes. Booking requires full pickup and delivery addresses: street, city, state, ZIP, contact name, phone, and email. Pass all --pickup-* and --delivery-* flags on the book command. Once a lane has been shipped, the delivery address is remembered for next time.

Run warp-agent login once on a trusted machine to generate ~/.warp/config.json, then mount that file into your CI runner as a secret (or write its contents as a secret and drop it at ~/.warp/config.json at job start). The CLI outputs JSON by default, which pipes cleanly into jq. A typical flow: quote, extract the PRICING_xxx quote ID, then book. Example: QUOTE=$(warp-agent ltl quote 90001 60601 --pallets 2 --weight 600 --dims 48x40x48 --date 2026-05-01) && QID=$(echo $QUOTE | jq -r .warp_quote_id) && warp-agent book $QID --pickup-street ... --delivery-street ...

The --format table mode flattens scalar values (strings, numbers, booleans) into a readable key-value layout. Nested objects like service and assumptions are serialized as JSON inline. For structured access to nested fields, use the default JSON output and pipe through jq. Example: warp-agent van quote 90001 90210 --pallets 2 --weight 800 --date 2026-04-15 | jq '.service.transit_days'.

Run warp-agent status. This hits the public /version endpoint with no authentication. If it returns the API version and commit hash, the API is up and your network is fine -- the problem is your key. If status itself fails, the API may be down or your network can't reach it.

Yes. The --base-url flag overrides the default endpoint. Pass the full base path, for example --base-url https://staging.wearewarp.com/api/v1. For HTTP proxies, set the standard HTTPS_PROXY environment variable -- Node's fetch respects it.

A firm quote means the price is locked, but it can still expire. The most common cause is calling book more than 15 minutes after the quote was created. Less commonly, the upstream carrier may have withdrawn capacity between your quote and book. Re-quote and book immediately.

Warp uses FAK (Freight All Kinds) rates, so freight class does not affect pricing. You can include it for your records and BOL accuracy, but it will not change the quoted price. This is by design -- it eliminates reclassification risk.