CLI for the REMA 1000 API. Designed for AI agent consumption.

Single Rust binary. JSON output. Auto token refresh.

---

Installation

curl -sfL https://raw.githubusercontent.com/Alfredvc/rema1000-cli/main/install.sh | bash

Requires Chrome or Chromium installed for auth login.

Agent Skills

Install skills for AI coding agents (Claude Code, Cursor, Gemini CLI, etc.):

npx skills add Alfredvc/rema1000-cli

Available skills:

• rema-shared — Authentication, output format, error handling, ID formats
• rema-shopping — Shopping list management: create lists, search products, add/manage items
• rema-discovery — Browse offers, weekly campaigns, find stores, view transactions

See AGENTS.md for the agent-specific command reference.

Authentication

rema auth login    # Opens browser for phone auth
rema auth status   # Check login state
rema auth logout   # Delete saved tokens

Tokens are saved to ~/.rema1000/tokens.json. Firebase tokens auto-refresh before expiry.

Usage

# App version (no auth required)
rema version

# Customer profile
rema customer get
rema customer minimal
rema customer update --home-store 1011141087892

# Offers and campaigns
rema offers list
rema campaigns list
rema campaigns list --type SP

# Product search
rema articles search "kylling" --rows 10
rema articles image 7057370030369 --output product.webp

# Stores
rema stores get 1011141087892
rema stores search 7033
rema stores hours 3198

# Transactions
rema transactions list
rema transactions get 1011726206912

# Shopping lists
rema lists list
rema lists get 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C
rema lists create "Groceries" --emoji "🛒" --theme BLUE
rema lists delete 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C
rema lists share 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C --name "Alfred"

# Shopping list items
rema items add 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C "Milk"
rema items add 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C "Kyllingfilet" --gtin 7057370030369 --description "1000 G" --store-area 11
rema items update 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C ITEM-UUID --state Inactive
rema items delete 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C ITEM-UUID
rema items clear 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C
rema items activate 29D9D5F0-99C0-4EA4-9452-ED1D5F95AC6C

Global Flags

Flag	Description
--json	Force compact JSON output
--fields f1,f2	Filter output to specific fields

Output

• Success: JSON to stdout, exit code 0
• Errors: {"error": "message"} to stderr, exit code 1
• Binary (images): raw bytes to stdout or --output <file>
• TTY: pretty-printed JSON; piped: compact JSON