Skip to content

AEnguerrand/splitwise-automation

Repository files navigation

Splitwise Automation CLI

CLI tool for Splitwise API automation.

Features

  • 📋 Groups Management - List and view groups
  • 👤 User Info - Get current user information
  • 🔧 Split Settings - Change group simplification settings
  • 💰 Expense Splits - Update expense splits with custom percentages
  • 🗺️ Multi-Group Operations - Apply different splits to multiple groups
  • 🔍 Simulation Mode - Preview balance changes before applying

Setup

  1. Get your API key from Splitwise
  2. Set environment variable: export SPLITWISE_API_KEY="your-key"
  3. Build: go build -o splitwise-automation

Usage

# List groups
./splitwise-automation groups list

# Get user info
./splitwise-automation user

# Enable simplification for groups
./splitwise-automation split change 123 456 --simplify

# Disable simplification for all groups
./splitwise-automation split change --all --no-simplify

# Change expense splits in a group with custom percentages
./splitwise-automation split expenses 123 --split "john@email.com:40,jane@email.com:60"
./splitwise-automation split expenses 456 --split "John Doe:30,Jane Smith:70"

# Change expense splits for multiple groups with different percentages
./splitwise-automation split expenses --groups-map "123:john@email.com:40,jane@email.com:60 456:alice@email.com:25,bob@email.com:75"

# Simulate changes without applying them (preview balance impact)
./splitwise-automation split expenses 123 --split "john@email.com:40,jane@email.com:60" --simulate
./splitwise-automation split expenses --groups-map "123:john:40,jane:60 456:alice:25,bob:75" --simulate

About

Automation script for Splitwise

Topics

Resources

License

Stars

Watchers

Forks