Postsale CLI
Ship from your terminal, your scripts, or your AI agent.
The Postsale CLI puts your Postsale account on the command line. Search orders, compare rates, buy and void labels, and run reports from a terminal, a scheduled job, or an AI agent. Type the exact command, or say what you want in plain language. Nothing spends money without your say-so.
Included with every plan. Mac and Windows, by invitation until the public download opens. API keys for unattended runs need the Soar plan.
Getting Started
Get started with Postsale CLI
Request an invitation
Email support@postsale.com and you receive a signed, self-contained program for Mac or Windows. Nothing else to install.
Sign in and check your setup
Run postsale auth login to sign in through your browser, or add --no-browser on a server. Then postsale doctor confirms your sign-in, carriers, and origin addresses in one pass.
Ask, or command
postsale orders work-queue shows what is ready to ship. postsale run "ship it with the cheapest carrier" does the rest and asks before it spends. The Quick Start walks through the first hour.
Features
What you get with the Postsale CLI
Direct commands or plain language
Type the exact command when you know what you want. Say what you want with postsale run when the work takes several steps. Same account, same carriers, same rules either way.
Nothing spends money without a say-so
Label purchases, voids, and deletes wait for an explicit go-ahead. Rehearse with dry-run first, or turn on test-label mode to print watermarked practice labels that are never billed.
Built for unattended runs
Results come back as structured data with stable exit codes, so a script or a scheduled job can branch on the outcome. Use an API key from Settings for jobs that run without you.
Ready for agent hosts
A published contract at postsale.com/cli/AGENTS.md lists all 61 tools, their safety classes, and how to recover from each error. One call to postsale schema --all bootstraps an agent.
Reports and end of day
Order counts, shipment counts, revenue, top items, and cost by carrier, plus the carrier manifests that close out the day. All from the terminal.
Same templates, same branding
Labels, packing slips, invoices, and emails use the templates already on your account. Manage them as records from the CLI and author them in the app.
Wherever the work runs
One program. Three ways to run it.
Use the CLI by hand, on a schedule, or from an agent. The safety gates stay in place in all three.
Your terminal
Direct commands with results as JSON. Pipe them into a script, or add --human to read them at a glance.
postsale orders work-queue
Scheduled jobs
Unattended runs sign in with an API key and fail closed when a step needs a go-ahead you did not give.
export POSTSALE_TOKEN=<key>
Agent hosts
An agent reads the published contract, then drives the CLI with every safety gate still in place.
https://postsale.com/cli/AGENTS.md
Every command
Everything the app does, from the terminal.
Orders & work queue
10 commands
orders work-queue
What is ready to ship right now, with the excluded orders counted so nothing hides in an unexpected status
orders search
Find orders with structured filters or a plain-language query like "orders from last 7 days"
orders get
Read one order in full, including items, addresses, and notes
orders create
Add an order from the terminal or a script
orders update
Change addresses, items, notes, or shipping preferences on an order
orders set-status
Move one order, or a whole query with bulk-status, to a new status
orders tag
Add or remove tags to organize and filter orders
orders recover
Bring an archived order back into the active list
filters
Saved order searches you can list, create, update, and reuse
stores list
See the storefronts connected to your account
orders work-queue
What is ready to ship right now, with the excluded orders counted so nothing hides in an unexpected status
orders search
Find orders with structured filters or a plain-language query like "orders from last 7 days"
orders get
Read one order in full, including items, addresses, and notes
orders create
Add an order from the terminal or a script
orders update
Change addresses, items, notes, or shipping preferences on an order
orders set-status
Move one order, or a whole query with bulk-status, to a new status
orders tag
Add or remove tags to organize and filter orders
orders recover
Bring an archived order back into the active list
filters
Saved order searches you can list, create, update, and reuse
stores list
See the storefronts connected to your account
See it in action
Natural language, real results.
> what should I ship today?
get_work_queue – 42 orders ready to ship; 9 excluded, sitting in On Hold and Awaiting Payment
42 orders are ready. Nine more are held back by their status, so nothing has slipped past you. Want the list, or shall I rate them?
Frequently asked questions
Bring Postsale to your terminal
Invitation-only release for Mac and Windows. Included with every plan.
Included with every plan · Nothing spends money without your say-so