🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Flatastic
πŸ¦€ ClawHub

Flatastic

by @david-schopf

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

Versionv1.0.0
Downloads465
#legal#productivity
TERMINAL
clawhub install flatastic

πŸ“– About This Skill

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     # Mark chore as done (partial name match)
flatastic remind   # 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

  • GET /chores β€” List all chores
  • GET /chores/next?id=&userId=&completedBy= β€” Mark as done
  • GET /chores/remind?id= β€” Send reminder
  • GET /chores/statistics β€” Get point statistics
  • GET /chores/history β€” Completion history
  • POST /chores β€” Create new chore
  • POST /chores/update β€” Update chore
  • DELETE /chores/id/:id β€” Delete chore

    • Shopping

  • GET /shoppinglist β€” List all items
  • POST /shoppinglist β€” Add item {name: "..."}
  • GET /shoppinglist/toggle_item?id= β€” Toggle bought
  • DELETE /shoppinglist/item/:id β€” Delete item
  • POST /shoppinglist/delete_bought_items β€” Clear bought

    • Expenses (Cashflow)

  • GET /cashflow?offset=&limit= β€” List expenses
  • GET /cashflow/settlement β€” Who owes whom
  • GET /cashflow/statistics β€” Expense stats
  • POST /cashflow β€” Add expense
  • DELETE /cashflow/id/:id β€” Delete expense

    • Shouts

  • GET /shouts β€” List shouts
  • POST /shouts β€” Post shout {shout: "..."}
  • DELETE /shouts/id/:id β€” Delete shout

    • WG

  • GET /wg β€” WG info with flatmates

    • Config File

    ~/.config/flatastic/config.json: 

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

    Notes

  • All commands support partial name matching (case-insensitive)
  • Amounts in expenses are in Euros (e.g., "24.50" or "24,50")
  • Reminders trigger push notifications to the assigned person

    • βš™οΈ Configuration

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

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

    πŸ“‹ Tips & Best Practices

  • All commands support partial name matching (case-insensitive)
  • Amounts in expenses are in Euros (e.g., "24.50" or "24,50")
  • Reminders trigger push notifications to the assigned person