kitchenowl-cli

What This Skill Does

The kitchenowl-cli skill provides a comprehensive terminal-based interface for managing your KitchenOwl household and pantry data. By bridging your local command line with the KitchenOwl API, this skill allows for rapid synchronization of shopping lists, recipe management, and inventory tracking without needing a graphical web browser. It is designed for power users who prefer keyboard-centric workflows and want to automate their kitchen management via scripting or direct shell interaction.

Installation

Installation is streamlined using pipx, ensuring that the tool is isolated from your system Python dependencies. To install, execute the following command in your terminal:

pipx install kitchenowl-cli

Verify the installation by running kitchenowl --version. If you need to update the tool in the future, simply run pipx upgrade kitchenowl-cli. Once installed, you must initialize your connection by running kitchenowl auth login --server <your-server-url>, which will securely store your authentication tokens in your local configuration directory.

Use Cases

This skill is ideal for:

1. Automating grocery list generation by piping external data or CSV files into the CLI.
2. Checking pantry stock levels quickly before heading to the store.
3. Managing complex recipe databases without the latency of a web UI.
4. Scripting automated notifications or cleanup tasks for shared household accounts.

Example Prompts

1. "Use kitchenowl-cli to list all items in my current shopping list and save the output as a JSON file named grocery_plan.json."
2. "Can you help me authenticate my KitchenOwl CLI? I have my server URL ready."
3. "Delete the item with ID 452 from my primary shopping list, but please ask me for confirmation before you finalize the removal."

Tips & Limitations

• Safety First: Always prioritize read-only commands (like list or status) to verify data before running destructive actions like delete.
• JSON Output: For any task involving complex data handling, always append the --json flag. This ensures the output is structured correctly for further parsing by OpenClaw or other command-line utilities.
• Configuration: Note that the CLI stores sensitive tokens in ~/.config/kitchenowl/config.json. Ensure your system permissions for this directory are restricted. If you encounter issues with multiple households, ensure you always pass the --household-id flag to prevent data from being sent to the incorrect context.