kitchenowl-cli

Original source / Raw SKILL.md

---
name: kitchenowl-cli
description: Use kitchenowl-cli from terminal with pipx install, auth, and core read/write commands for KitchenOwl.
metadata: {"author":"KitchenOwl","homepage":"https://github.com/kitchenowl/kitchenowl-cli","openclaw":{"requires":{"anyBins":["kitchenowl"]},"install":["pipx install kitchenowl-cli"]}}
---

# 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.

```bash
pipx install kitchenowl-cli
kitchenowl --help
kitchenowl --version
```

Upgrade:

```bash
pipx upgrade kitchenowl-cli
```

## Authentication

```bash
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

1. Start with read-only commands before mutating data.
2. Ask for confirmation before destructive commands (`delete`, `remove-item`, bulk edits).
3. Prefer explicit IDs and `--household-id` for all scoped commands.
4. 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


---

## Referenced Files

> The following files are referenced in this skill and included for context.

### references/commands.md

```markdown
# KitchenOwl CLI Command Reference

Install:

```bash
pipx install kitchenowl-cli
```

## Auth

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

## Server settings

```bash
kitchenowl config server-settings
kitchenowl config server-settings --json
```

## Household

```bash
kitchenowl household list
kitchenowl household get 8
kitchenowl household member list --household-id 8
```

## Shopping list

```bash
kitchenowl shoppinglist list --household-id 8
kitchenowl shoppinglist create "Weekly" --household-id 8
kitchenowl shoppinglist add-item-by-name 12 Milk --description "2L"
kitchenowl shoppinglist remove-item 12 456 -y
```

## Recipe

```bash
kitchenowl recipe list --household-id 8
kitchenowl recipe get 123
kitchenowl recipe add --household-id 8 --name "Tomato Soup" --yields 2 --time 25
kitchenowl recipe edit 123 --description "Updated"
kitchenowl recipe delete 123
```

## User admin

```bash
kitchenowl user list
kitchenowl user get 3
kitchenowl user search andreas
```

```



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "apetersson",
  "slug": "kitchenowl",
  "displayName": "KitchenOwl",
  "latest": {
    "version": "1.0.0",
    "publishedAt": 1771423862373,
    "commit": "https://github.com/openclaw/skills/commit/13170eed4c3fc6c1213c50b4d039023454207b0c"
  },
  "history": []
}

```