kitchenowl-cli

TotalClaw 作者 KitchenOwl

从终端使用 kitchenowl-cli 以及 pipx install、auth 和 KitchenOwl 的核心读/写命令。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~apetersson-kitchenowl

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~apetersson-kitchenowl/file -o apetersson-kitchenowl.md

## 概述（中文）

从终端使用 kitchenowl-cli 以及 pipx install、auth 和 KitchenOwl 的核心读/写命令。

## 原文

# 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