Wallos Skill

A Cursor Agent Skill for managing subscriptions via Wallos — the open-source personal subscription tracker.

Features

• List and filter subscriptions (active/inactive, by category, payment method)
• View categories, payment methods, currencies, household members
• Calculate monthly/yearly spending statistics
• Track upcoming payments

Setup

1. Clone or install this skill into ~/.agents/skills/wallos/
2. Set environment variables:

export WALLOS_URL="https://your-wallos-instance.com"
export WALLOS_API_KEY="your-api-key-here"

3. The Cursor Agent will automatically use this skill when you ask about subscriptions

Structure

├── SKILL.md                    # Skill entry point
├── reference/
│   └── api-endpoints.md        # Full Wallos API documentation
└── scripts/
    └── wallos-api.py           # CLI helper (list, stats, upcoming, etc.)

Usage

python3 ~/.agents/skills/wallos/scripts/wallos-api.py list --active
python3 ~/.agents/skills/wallos/scripts/wallos-api.py stats
python3 ~/.agents/skills/wallos/scripts/wallos-api.py upcoming --days 30

Notes

• API key provides read-only access to GET endpoints
• Write operations (add/edit/delete) require session authentication via the Wallos Web UI
• Cloudflare-protected instances are supported (built-in User-Agent header)