Manage personal subscriptions via Wallos (self-hosted tracker). Use when the user asks to view, add, edit, or delete subscriptions, check spending, manage categories/payment methods, or anything related to subscription tracking and recurring expenses.
Interact with the user's self-hosted Wallos instance to manage subscriptions, categories, payment methods, and spending analytics.
Set these environment variables before using the skill:
export WALLOS_URL="https://your-wallos-instance.com"
export WALLOS_API_KEY="your-api-key-here"
api_key query parameter (GET) or form field (POST)Run the helper script for any Wallos operation:
python3 ~/.agents/skills/wallos/scripts/wallos-api.py <action> [args...]
| Action | Description | Example |
|---|---|---|
list | List all subscriptions | python3 ~/.agents/skills/wallos/scripts/wallos-api.py list |
list --active | Active subscriptions only | python3 ~/.agents/skills/wallos/scripts/wallos-api.py list --active |
list --sort price | Sort by price | python3 ~/.agents/skills/wallos/scripts/wallos-api.py list --sort price |
categories | List all categories | python3 ~/.agents/skills/wallos/scripts/wallos-api.py categories |
payments | List payment methods | python3 ~/.agents/skills/wallos/scripts/wallos-api.py payments |
currencies | List currencies | python3 ~/.agents/skills/wallos/scripts/wallos-api.py currencies |
household | List household members | python3 ~/.agents/skills/wallos/scripts/wallos-api.py household |
stats | Spending summary | python3 ~/.agents/skills/wallos/scripts/wallos-api.py stats |
upcoming | Next 30 days payments | python3 ~/.agents/skills/wallos/scripts/wallos-api.py upcoming |
The script returns structured JSON. Parse and present results in a user-friendly format with tables or bullet points.
python3 ~/.agents/skills/wallos/scripts/wallos-api.py listAdding requires session authentication (username/password login via /login.php). The API key alone is read-only for subscription mutations.
For now, guide the user to add subscriptions via the Wallos Web UI.
listFor full API endpoint documentation, read: ~/.agents/skills/wallos/reference/api-endpoints.md
convert_currency=true for main currency