Initial commit for helios-splitwise

README.md

@@ -0,0 +1,15 @@
+# Helios Splitwise Skill
+
+Access Moritz' Splitwise account via API.
+View groups, balances, expenses and friends.
+
+## Setup
+
+Requires `SPLITWISE_API_KEY` in `~/.openclaw/secrets/splitwise.env`.
+
+## Features
+
+- View group balances
+- List recent expenses
+- Check pending payments
+- (Limited) Create new expenses

SKILL.md

@@ -0,0 +1,62 @@
+---
+name: splitwise
+description: Access Splitwise to check balances, expenses, and groups.
+---
+
+# Splitwise
+
+Access Moritz' Splitwise account via API.
+
+## Auth
+
+API key in `~/.openclaw/secrets/splitwise.env`. Use as Bearer token.
+
+## Base URL
+
+`https://secure.splitwise.com/api/v3.0`
+
+## Common Requests
+
+### Current user
+```bash
+source ~/.openclaw/secrets/splitwise.env
+curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_current_user"
+```
+
+### Groups (with balances)
+```bash
+curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_groups"
+```
+
+### Expenses (recent, paginated)
+```bash
+curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_expenses?limit=20&offset=0"
+```
+
+### Expenses for a group
+```bash
+curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_expenses?group_id=GROUP_ID&limit=20"
+```
+
+### Friends
+```bash
+curl -s -H "Authorization: Bearer $SPLITWISE_API_KEY" "https://secure.splitwise.com/api/v3.0/get_friends"
+```
+
+### Create expense (equal split between 2 users)
+```bash
+curl -s -X POST -H "Authorization: Bearer $SPLITWISE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"cost":"10.00","description":"Dinner","currency_code":"EUR","group_id":0,"users__0__user_id":71761923,"users__0__paid_share":"10.00","users__0__owed_share":"5.00","users__1__user_id":OTHER_USER_ID,"users__1__paid_share":"0","users__1__owed_share":"5.00"}' \
+  "https://secure.splitwise.com/api/v3.0/create_expense"
+```
+
+## IDs
+
+- Moritz: 71761923
+
+## Notes
+
+- All amounts in EUR
+- NIEMALS Ausgaben erstellen ohne Moritz' Zustimmung
+- Rate limits apply (personal API)