Cupboard CLI

A command-line tool for Cupboard — manage your family's recipes, meal plans, and grocery lists from the terminal.

Built for both humans and AI agents.

Install

npm install -g cupboard-cli

Quick Start

# Log in (sends a code to your email)
cupboard login --email [email protected]

# Enter the code from your email
cupboard verify --email [email protected] --code 123456

# You're in!
cupboard whoami

Commands

Family Setup

cupboard create-family "The Smiths"  # Create a new family
cupboard join ABC12345               # Join with an invite code

Recipes

cupboard recipes list                    # List all recipes
cupboard recipes list --tag "favorites"  # Filter by tag
cupboard recipes get <id>                # View a recipe
cupboard recipes create --title "Tacos" --ingredients "tortillas,beef,salsa" --steps "Cook beef,Assemble tacos"
cupboard recipes update <id> --tags "quick,mexican"
cupboard recipes delete <id>

Meal Plans

cupboard meal-plan list                          # View meal plans
cupboard meal-plan add <recipe-id> --date 2026-04-20  # Plan a meal
cupboard meal-plan remove <id>                   # Remove from plan
cupboard meal-plan complete <id>                 # Mark as done

Grocery Lists

Works standalone — no recipes required.

cupboard grocery show                    # View your list
cupboard grocery add "milk"              # Add an item
cupboard grocery check "milk"            # Mark as bought
cupboard grocery remove "milk"           # Remove an item
cupboard grocery generate <id1> <id2>    # Generate from recipes

Output

All commands output JSON by default. Add --pretty for human-readable formatting.

AI Agents

Cupboard is designed to work with AI agents like OpenClaw, Hermes, and Claude Code.

cupboard skill   # Print full agent instructions

License

MIT