Open Source CLI

Zona Sul groceries
from your terminal

Search products, build a cart, schedule delivery, and place orders. Structured output for AI agents, colored text for humans. 

Install the zonasul CLI skill for grocery ordering in Rio de Janeiro.
Run: npx skills add -g voska/zonasul

Copy and paste into Claude Code or any AI agent

View on GitHub
zsh
$ zonasul search "banana" --limit 3
1 Banana Prata SKU:33277 R$8.79
2 Banana Prata Organica 800g SKU:6180 R$10.99
3 Banana Nanica SKU:33278 R$5.49
$ zonasul cart add 33277 --qty 3
Added 33277 to cart.
$ zonasul delivery windows --json | jq '.[0]'
{
  "start": "2026-03-06T14:01:00Z",
  "end": "2026-03-06T16:00:59Z",
  "price": 700
}
$ zonasul checkout --window 0 --cvv 123 --confirm
Order placed! ID: v-1234567890

Built for agents and humans

Three output modes, structured exit codes, and a full grocery workflow. From search to doorstep.

JSON / Human / Plain

--json for agents, colored output for humans, --plain for pipelines. Stderr for hints, stdout for data.

Agent-First

Structured exit codes, --no-input mode, and zonasul schema for JSON introspection. Built for Claude Code.

Full Grocery Workflow

Search products, manage your cart, pick a delivery window, and checkout. Handles address, payment, and order placement.

Secure Auth

JWT tokens stored in macOS Keychain. CVV passed via flag or environment variable, never stored on disk.

Recipe Mode

Give an AI agent a recipe and it searches, prices, and orders all the ingredients. Includes Portuguese grocery term translations.

Cross-Platform

Pure Go binary. Install via Homebrew, go install, or download from GitHub Releases. No dependencies.

Install

One command. No dependencies.

$ brew install voska/tap/zonasul

macOS and Linux

Quick Start

From install to groceries at your door.

1 Authenticate with Zona Sul 
$ zonasul auth login
Paste JWT token: eyJhbGciOi...
Logged in as: maria@example.com
2 Search and add products 
$ zonasul search "arroz" --limit 3
1    Arroz Camil Tipo 1 5kg                            SKU:11234   R$29.90
2    Arroz Integral Tio Joao 1kg                       SKU:11240   R$8.49
3    Arroz Arborio Riso Gallo 500g                     SKU:11251   R$15.90

$ zonasul cart add 11234
3 Pick a delivery window 
$ zonasul delivery windows
0    Thu 06 Mar 14:01 — 16:00  R$7.00
1    Thu 06 Mar 16:01 — 21:00  Gratis
2    Fri 07 Mar 08:01 — 13:00  Gratis
4 Place the order 
$ zonasul checkout --window 1 --cvv 123 --confirm
Order placed! ID: v-1234567890

FAQ

What is zonasul CLI?
zonasul is a free, open-source command-line interface for ordering groceries from Zona Sul supermarket in Rio de Janeiro, Brazil. It lets you search products, manage a shopping cart, schedule delivery, and place orders from your terminal. It outputs structured JSON for AI agents, colored text for humans, and plain text for shell pipelines. Written in Go with zero runtime dependencies.
How do I install zonasul?
On macOS or Linux: brew install voska/tap/zonasul. With Go: go install github.com/voska/zonasul/cmd/zonasul@latest. Or download binaries directly from GitHub Releases.
Can I use zonasul with AI agents?
Yes. zonasul is designed agent-first. It provides structured JSON output via --json, machine-readable exit codes (0-10), a --no-input flag for non-interactive use, and a zonasul schema command for introspection. Install as a Claude Code skill with: npx skills add -g voska/zonasul. Give it a recipe and it will search, price, and order all ingredients.
Does Zona Sul deliver to my neighborhood?
Zona Sul delivers to select neighborhoods in Rio de Janeiro including Leblon, Ipanema, Copacabana, Botafogo, Laranjeiras, Flamengo, and surrounding areas. You need a Zona Sul account at zonasul.com.br with a registered delivery address.