{"skill":{"slug":"flatastic","displayName":"Flatastic","summary":"Manage shared household chores, shopping lists, and expenses via Flatastic. Use when user asks about chores, WG tasks, shopping list, expenses, or Flatastic.","description":"---\nname: flatastic\ndescription: Manage shared household chores, shopping lists, and expenses via Flatastic. Use when user asks about chores, WG tasks, shopping list, expenses, or Flatastic.\nmetadata:\n  clawdbot:\n    emoji: \"🏠\"\n    requires:\n      bins: [\"flatastic\"]\n---\n\n# Flatastic CLI\n\nCLI for managing shared household in Flatastic (WG-App).\n\n## Installation\n\n```bash\ncd ~/Projects/flatastic-cli\nnpm install\nnpm run build\nnpm link\n```\n\nAfter linking, `flatastic` is available globally.\n\n## Setup\n\n```bash\nflatastic auth             # Login with email/password\nflatastic refresh          # Refresh WG data from server\n```\n\nToken + user/WG info saved to `~/.config/flatastic/config.json`\n\n## Commands\n\n### Chores\n\n```bash\nflatastic chores           # List all chores with assignee, points, due dates\nflatastic done <search>    # Mark chore as done (partial name match)\nflatastic remind <search>  # Send reminder notification for a chore\nflatastic stats            # Show chore statistics & leaderboard\nflatastic history          # Show chore completion history\nflatastic history -l 50    # Show last 50 entries\n```\n\n### Shopping List\n\n```bash\nflatastic shop             # Show pending items (shortcut)\nflatastic shop -a          # Show all items (including bought)\n\nflatastic shopping list    # Show pending items\nflatastic shopping add \"Milch\"  # Add item to list\nflatastic shopping done milch   # Mark item as bought\nflatastic shopping delete milch # Remove item from list\nflatastic shopping clear        # Clear all bought items\n```\n\n### Expenses / Finances\n\n```bash\nflatastic expenses         # Show recent expenses\nflatastic expenses -l 20   # Show last 20 expenses\nflatastic balances         # Show who owes whom\nflatastic expense \"Pizza\" 24.50           # Add expense, split with all\nflatastic expense \"Taxi\" 15 -s \"David\"    # Split only with David\n```\n\n### WG Info\n\n```bash\nflatastic wg               # Show WG info and flatmates with points\n```\n\n### Shouts (Messages/Bulletin Board)\n\n```bash\nflatastic shouts           # Show recent shouts\nflatastic shout \"Pizza ist da!\"  # Post a new shout\n```\n\n## Usage Examples\n\n**\"Was steht heute an?\"**\n```bash\nflatastic chores\n```\n\n**\"Hake Staubsaugen ab\"**\n```bash\nflatastic done staubsaugen\n```\n\n**\"Erinner mal wegen Müll\"**\n```bash\nflatastic remind müll\n```\n\n**\"Wer hat die meisten Punkte?\"**\n```bash\nflatastic stats\n```\n\n**\"Was muss ich noch einkaufen?\"**\n```bash\nflatastic shop\n```\n\n**\"Setz Milch auf die Liste\"**\n```bash\nflatastic shopping add \"Milch\"\n```\n\n**\"Hab ich gekauft\"**\n```bash\nflatastic shopping done milch\n```\n\n**\"Wer schuldet wem Geld?\"**\n```bash\nflatastic balances\n```\n\n**\"Ich hab 24€ für Pizza bezahlt\"**\n```bash\nflatastic expense \"Pizza\" 24\n```\n\n## API Endpoints Discovered\n\n### Chores\n- `GET /chores` — List all chores\n- `GET /chores/next?id=&userId=&completedBy=` — Mark as done\n- `GET /chores/remind?id=` — Send reminder\n- `GET /chores/statistics` — Get point statistics\n- `GET /chores/history` — Completion history\n- `POST /chores` — Create new chore\n- `POST /chores/update` — Update chore\n- `DELETE /chores/id/:id` — Delete chore\n\n### Shopping\n- `GET /shoppinglist` — List all items\n- `POST /shoppinglist` — Add item `{name: \"...\"}`\n- `GET /shoppinglist/toggle_item?id=` — Toggle bought\n- `DELETE /shoppinglist/item/:id` — Delete item\n- `POST /shoppinglist/delete_bought_items` — Clear bought\n\n### Expenses (Cashflow)\n- `GET /cashflow?offset=&limit=` — List expenses\n- `GET /cashflow/settlement` — Who owes whom\n- `GET /cashflow/statistics` — Expense stats\n- `POST /cashflow` — Add expense\n- `DELETE /cashflow/id/:id` — Delete expense\n\n### Shouts\n- `GET /shouts` — List shouts\n- `POST /shouts` — Post shout `{shout: \"...\"}`\n- `DELETE /shouts/id/:id` — Delete shout\n\n### WG\n- `GET /wg` — WG info with flatmates\n\n## Config File\n\n`~/.config/flatastic/config.json`:\n```json\n{\n  \"token\": \"...\",\n  \"user\": { \"id\": \"...\", \"firstName\": \"...\", \"chorePoints\": \"...\" },\n  \"wg\": {\n    \"name\": \"...\",\n    \"flatmates\": [{ \"id\": \"...\", \"firstName\": \"...\" }, ...]\n  }\n}\n```\n\n## Notes\n\n- All commands support partial name matching (case-insensitive)\n- Amounts in expenses are in Euros (e.g., \"24.50\" or \"24,50\")\n- Reminders trigger push notifications to the assigned person\n","topics":["Shopping"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":577,"installsAllTime":22,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773398938009,"updatedAt":1778491880948},"latestVersion":{"version":"1.0.0","createdAt":1773398938009,"changelog":"- Initial release of Flatastic CLI skill for managing shared household chores, shopping lists, and expenses.\n- Supports authentication, chore management, shopping list operations, expense and balance tracking, and bulletin board messaging.\n- Offers comprehensive command set for flat routines: chores, shopping, expenses, and WG info.\n- Enables partial name matching for easier, faster interactions.\n- Integrates with the Flatastic API to synchronize data, trigger reminders, and update household activity.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"david-schopf","userId":"s1768zwedtjmxpacw3x4eyp87183jc88","displayName":"david-schopf","image":"https://avatars.githubusercontent.com/u/7288717?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089868926}}