M Matrixly.AI User guide

// SHIP · LIVE · SHIPSTATION HUB

Shipping Assistant

Track shipments, notify stakeholders, and handle exceptions for logistics and distribution SMEs.

ShipStation hub Exception scan WISMO drafts HITL cancel/label

1. Track

Orders and shipments via ShipStation — carriers UPS, FedEx, USPS through one hub.

2. Exceptions

Late, undeliverable, address issues — prioritized queue for ops.

3. Notify

Stakeholder + customer WISMO drafts (human sends — fewer support tickets).

4. Order → delivery

Awaiting → shipped → delivered, with HITL on cancel / address / labels.

Full order-to-delivery flow

Aligned with the marketplace logistics swimlanes — agent-orchestrated fulfillment for SMBs.

  1. 01

    Order capture

    Import multi-channel orders into ShipStation.

  2. 02

    Rate & label

    Carrier selection (UPS / FedEx / USPS) — label actions need approval.

  3. 03

    In transit monitor

    Track status, ETA, exception flags.

  4. 04

    Delivery & WISMO

    Confirm delivery; draft customer updates when things go wrong.

View multi-agent logistics flow on homepage →

Deploy on this machine

Code: agents/shipping-assistant · Hermes skill: shipping-assistant · Design: DESIGN.md

Demo (no API keys)

cd C:\Users\anwar\projects\matrix-six\agents\shipping-assistant
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python -m src.cli demo
python -m src.cli exceptions
python -m src.cli wismo --order MB-10418
python -m src.cli notify-drafts

Live ShipStation

  1. ShipStation → Settings → Account → API Settings
  2. Copy Key + Secret into agents/shipping-assistant/.env
  3. Run python -m src.cli status → mode live
SHIPSTATION_API_KEY=...
SHIPSTATION_API_SECRET=...

Hermes

hermes -s shipping-assistant -z "Scan shipping exceptions and draft WISMO for the worst order"
Safety: WISMO and exception emails are drafts only. Cancel / address change / create label require human approval (HITL queue).