splitwise-cli

README

splitwise

A fast CLI for Splitwise. Manage groups, expenses, balances, and settlements from your terminal.

Install

brew tap barronlroth/tap
brew install splitwise

Or with Go:

go install github.com/barronlroth/splitwise-cli@latest

Setup

1. Register a Splitwise app at secure.splitwise.com/apps
   • Set the callback URL to http://localhost:8484/callback
2. Authenticate:

splitwise auth

You'll be prompted for your Client ID and Client Secret. The CLI opens your browser for OAuth, then stores the token at ~/.config/splitwise-cli/auth.json.

Note: Splitwise ignores redirect_uri in OAuth requests and always uses the registered callback URL. If you hit ERR_CONNECTION_REFUSED after authorizing, do a manual token exchange with curl using the code from the URL.

Usage

# Who am I?
splitwise me

# Groups & balances
splitwise groups
splitwise group "Apartment"

# Expenses
splitwise expenses list --group "Apartment" --limit 20
splitwise expenses list --after 2025-01-01
splitwise expenses create "Dinner" 85.50 --group "Apartment"
splitwise expenses delete 123456

# Balances
splitwise balances
splitwise balances --group "Apartment"

# Friends
splitwise friends

# Settle up
splitwise settle "Nina" --group "Apartment"

# Set defaults
splitwise config set default_group "Apartment"
splitwise config set default_currency USD
splitwise config show

Output

Flag	Description
--json	Raw JSON
--quiet	IDs/amounts only (for scripting)
--no-color	No ANSI colors (also respects NO_COLOR)

splitwise expenses list --quiet | head -5
splitwise balances --json | jq '.[] | select(.amount != "0.00")'

AI Agent Integration

This CLI ships with an OpenClaw / Gemini CLI skill file. Drop skills/splitwise/SKILL.md into your agent's skills directory to let your AI assistant manage Splitwise expenses conversationally.

Configuration

File	Purpose
~/.config/splitwise-cli/auth.json	OAuth token
~/.config/splitwise-cli/config.json	User preferences

License

MIT