KitchenOwl CLI Skill

Use this skill when the user wants to install and operate KitchenOwl via the kitchenowl CLI.

Install and verify

Prefer pipx for isolated CLI installs.

pipx install kitchenowl-cli
kitchenowl --help
kitchenowl --version

Upgrade:

pipx upgrade kitchenowl-cli

Authentication

kitchenowl auth login --server https://kitchenowl.example.com
kitchenowl auth status
kitchenowl auth logout

auth login accepts --username and --password flags (or prompts interactively) and always asks for the server when --server is omitted, defaulting to the last saved host. The CLI stores server_url, access_token, refresh_token, user, and any saved defaults in ~/.config/kitchenowl/config.json (or $XDG_CONFIG_HOME/kitchenowl/config.json). auth logout removes the tokens from that file but leaves the configured server URL.

Command usage rules

• Start with read-only commands before mutating data.
• Ask for confirmation before destructive commands (delete, remove-item, bulk edits).
• Prefer explicit IDs and --household-id for all scoped commands.
• Use --json whenever output is consumed programmatically.

Core command groups

Use references/commands.md as the canonical command set for:

• auth
• config/server settings
• households and members
• shopping lists
• recipes
• users