kronan-cli

---

name: kronan-cli

description: >

CLI tool for Kronan.is, Iceland's grocery store. Search products, manage cart,

view orders. Requires GitHub CLI for install. Stores auth tokens at

~/.kronan/tokens.json. Requires Icelandic phone number with Rafraen skilriki.

version: 0.1.0

requires:

binaries:

- gh # GitHub CLI — required for install

- bun # Bun runtime — only needed if building from source

paths:

- ~/.kronan/tokens.json # Cognito JWT tokens (created at login)

metadata:

openclaw:

homepage: https://github.com/arnif/kronan-cli

emoji: "\U0001F6D2"

---

# kronan-cli

CLI tool for shopping at [Kronan.is](https://www.kronan.is), Iceland's grocery store chain. Designed for both humans and AI agents.

Prerequisites

Install

gh repo clone arnif/kronan-cli /tmp/kronan-cli && bash /tmp/kronan-cli/install.sh

**What this does:** clones the repo to `/tmp/kronan-cli`, then `install.sh` downloads a pre-built binary from the latest GitHub release and places it at `~/.local/bin/kronan` (override with `INSTALL_DIR`).

To build from source instead:

gh repo clone arnif/kronan-cli && cd kronan-cli
bun install && bun build --compile src/index.ts --outfile kronan
mv kronan ~/.local/bin/

Security and privacy

Authentication

kronan login <phone-number>

You will be prompted to confirm on your phone. Tokens are stored locally in `~/.kronan/tokens.json` and refresh automatically.

kronan logout    # Clear stored tokens
kronan status    # Check login status

Commands

Search products

kronan search "mjolk"
kronan search "epli" --limit 5
kronan search "braud" --json

Product details

kronan product <sku>
kronan product 02500188 --json

Cart management

kronan cart                         # View cart
kronan cart add <sku> [quantity]    # Add item
kronan cart update <lineId> <qty>  # Update quantity
kronan cart remove <lineId>        # Remove item

Order history

kronan orders                # Recent orders
kronan orders --json         # JSON output for parsing
kronan order <id>            # Specific order details

User profile

kronan me              # ⚠️  Outputs PII (name, phone, kennitala)
kronan me --json

AI Agent Usage

All commands support `--json` for structured output. This makes kronan-cli suitable as a tool for AI agents managing grocery shopping.

**Important:** Commands that change state (`cart add`, `cart update`, `cart remove`, `login`) can modify the user's real shopping cart or initiate authentication. Agents **must ask for explicit user confirmation** before running any state-changing command.

Read-only commands (`search`, `product`, `orders`, `order`, `cart` (view), `me`, `status`) are safe to run without confirmation.

Example agent workflow:

# 1. Check what the user usually buys
kronan orders --json

# 2. Search for a specific product
kronan search "nymjolk" --json --limit 5

# 3. Add items to cart
kronan cart add 100224198 6
kronan cart add 02200946 1

# 4. Review the cart
kronan cart --json

Typical weekly shopping pattern

An agent can analyze order history to find frequently purchased items and auto-populate the cart:

1. Fetch orders with `kronan orders --json`

2. Count product frequency across orders (by SKU)

3. Add the top items at their typical quantities with `kronan cart add <sku> <qty>`

4. Present the cart for user review with `kronan cart`

Flags

| Flag | Description |

|------|-------------|

| `--json` | Structured JSON output (for AI agents) |

| `--page <n>` | Page number (search) |

| `--limit <n>` | Results per page |

| `--offset <n>` | Offset for pagination (orders) |

| `--store <extId>` | Store external ID (search, default: 159) |

API Reference

The CLI wraps the Kronan backend API at `https://backend.kronan.is/api/`. Key endpoints:

| Endpoint | Method | Auth | Description |

|----------|--------|------|-------------|

| `/products/raw-search/` | POST | No | Product search |

| `/products/{sku}/` | GET | No | Product detail |

| `/smart-checkouts/default/` | GET | Yes | View cart |

| `/smart-checkouts/default/lines/` | POST | Yes | Add to cart |

| `/smart-checkouts/default/lines/{id}/` | PATCH | Yes | Update cart line |

| `/smart-checkouts/default/lines/{id}/` | DELETE | Yes | Remove from cart |

| `/orders/` | GET | Yes | Order history |

| `/users/me/` | GET | Yes | User profile |

| `/customer_groups/` | GET | Yes | Customer groups |

Auth header format: `Authorization: CognitoJWT {idToken}`

Cart endpoints also require: `Customer-Group-Id: {groupId}`