Loading...
Loading...
Use when helping with the Splitwise CLI (splitwisecli) — splitting bills, tracking shared expenses between friends, recording expenses, settling debts, or checking balances. Use for 'Splitwise', 'split receipts', 'split bills', 'who owes whom', 'expense tracking', 'splitwisecli', 'divide costs', or 'settle up'.
npx skill4agent add oristides/splitwisecli splitwise-cliSPLITWISE_CONSUMER_KEY.env# No Go required
curl -fsSL https://raw.githubusercontent.com/oristides/splitwisecli/main/install.sh | shexport SPLITWISE_CONSUMER_KEY=your_consumer_key_here
export SPLITWISE_CONSUMER_SECRET=your_consumer_secret_here
export SPLITWISE_API_KEY=your_api_key_here | Command | Purpose |
|---|---|
| Current user |
| Friends (IDs for expenses) |
| Groups |
| Group by ID or name |
| All friend balances |
| Balance with one friend |
| Balances in group |
| List expenses |
| Create expense |
| Update expense |
| Record payment |
| Delete expense |
--json-j--paid-by--paid-by friend--paid-by 456--split# You paid $100, split 50/50
splitwisecli expense create --friend 456 -d "Dinner" -c 100
# Custom split: percentages (must sum to 100). Cost $120 → 40%=$48, 60%=$72
splitwisecli expense create --friend 456 -d "Restaurant" -c 120 --split 40,60
# They owe you full amount
splitwisecli expense create --friend 456 -d "Groceries" -c 80 --split 0,100
# Friend paid — you owe them
splitwisecli expense create --friend 456 -d "Dinner" -c 100 --paid-by friend--group 123--group "Trip to Japan"# You paid, split equally
splitwisecli expense create --group 123 -d "Movie tickets" -c 60 --equal
# Specific member paid
splitwisecli expense create --group 123 -d "Dinner" -c 90 --equal --paid-by 789# You pay friend back (default)
splitwisecli expense settle --friend 456 --amount 50
# Friend pays you back
splitwisecli expense settle --friend 456 --amount 50 --paid-by friend
# Group: who pays, who receives
splitwisecli expense settle --group "Trip" --amount 100 --paid-by me --to 789splitwisecli expense update 789 --description "Dinner at Mario's"
splitwisecli expense update 789 --cost 95
splitwisecli expense update 789 --split 40,60| Flag | Values | Notes |
|---|---|---|
| | Default: you |
| | Must sum to 100 |
| User ID | Friend's ID from |
| ID or name | Resolves by name |
| User ID | Required with |
splitwisecli
├── user # User operations
│ ├── me # Get current user
│ └── get # Get user by ID
├── group # Group operations
│ ├── list # List all groups
│ └── get # Get group by ID or name
├── friend # Friend operations
│ └── list # List all friends (with IDs and balances)
├── balance # Balance operations
│ └── (default) # Show balances (--friend, --group)
├── expense # Expense operations
│ ├── list # List expenses
│ ├── get # Get expense details
│ ├── create # Create expense (--friend or --group)
│ ├── update # Update expense (fix mistakes)
│ ├── settle # Record a payment / settle up
│ └── delete # Delete expense
├── comment # Comment operations
│ ├── list # Get expense comments
│ └── create # Add comment
├── notification # Notification operations
│ └── list # List notifications
└── other # Utilities
├── currencies # List currencies
└── categories # List categories