Flatastic CLI

---

name: flatastic

description: Manage shared household chores, shopping lists, and expenses via Flatastic. Use when user asks about chores, WG tasks, shopping list, expenses, or Flatastic.

metadata:

clawdbot:

emoji: "🏠"

requires:

bins: ["flatastic"]

---

# Flatastic CLI

CLI for managing shared household in Flatastic (WG-App).

Installation

cd ~/Projects/flatastic-cli
npm install
npm run build
npm link

After linking, `flatastic` is available globally.

Setup

flatastic auth             # Login with email/password
flatastic refresh          # Refresh WG data from server

Token + user/WG info saved to `~/.config/flatastic/config.json`

Commands

Chores

flatastic chores           # List all chores with assignee, points, due dates
flatastic done <search>    # Mark chore as done (partial name match)
flatastic remind <search>  # Send reminder notification for a chore
flatastic stats            # Show chore statistics & leaderboard
flatastic history          # Show chore completion history
flatastic history -l 50    # Show last 50 entries

Shopping List

flatastic shop             # Show pending items (shortcut)
flatastic shop -a          # Show all items (including bought)

flatastic shopping list    # Show pending items
flatastic shopping add "Milch"  # Add item to list
flatastic shopping done milch   # Mark item as bought
flatastic shopping delete milch # Remove item from list
flatastic shopping clear        # Clear all bought items

Expenses / Finances

flatastic expenses         # Show recent expenses
flatastic expenses -l 20   # Show last 20 expenses
flatastic balances         # Show who owes whom
flatastic expense "Pizza" 24.50           # Add expense, split with all
flatastic expense "Taxi" 15 -s "David"    # Split only with David

WG Info

flatastic wg               # Show WG info and flatmates with points

Shouts (Messages/Bulletin Board)

flatastic shouts           # Show recent shouts
flatastic shout "Pizza ist da!"  # Post a new shout

Usage Examples

**"Was steht heute an?"**

flatastic chores

**"Hake Staubsaugen ab"**

flatastic done staubsaugen

**"Erinner mal wegen Müll"**

flatastic remind müll

**"Wer hat die meisten Punkte?"**

flatastic stats

**"Was muss ich noch einkaufen?"**

flatastic shop

**"Setz Milch auf die Liste"**

flatastic shopping add "Milch"

**"Hab ich gekauft"**

flatastic shopping done milch

**"Wer schuldet wem Geld?"**

flatastic balances

**"Ich hab 24€ für Pizza bezahlt"**

flatastic expense "Pizza" 24

API Endpoints Discovered

Chores

Shopping

Expenses (Cashflow)

Shouts

WG

Config File

`~/.config/flatastic/config.json`:

{
  "token": "...",
  "user": { "id": "...", "firstName": "...", "chorePoints": "..." },
  "wg": {
    "name": "...",
    "flatmates": [{ "id": "...", "firstName": "..." }, ...]
  }
}

Notes