Splitwise CLI Skill

Manage shared expenses, balances, and settlements through the

splitwise

CLI.

Setup

The CLI is installed at

~/.local/bin/splitwise

and authenticated via OAuth 2.0. Token is at

~/.config/splitwise-cli/auth.json

. If auth expires, the CLI will tell you — run

splitwise auth

to re-authenticate (requires browser OAuth flow).

The default group is configured as Dolores (Barron + Nina's shared expenses group). You don't need to pass

--group

for their shared expenses.

Quick Reference

Check balances

# Default group (Dolores) balances
splitwise balances

# Specific group
splitwise balances --group "Aspen 23"

List expenses

# Recent expenses in default group
splitwise expenses list --limit 10

# Date-filtered
splitwise expenses list --after 2026-03-01 --before 2026-03-31

# Different group
splitwise expenses list --group "Rome" --limit 5

Create an expense

# Even split, you (Barron) paid — most common case
splitwise expenses create "Xfinity Internet - March" 51.30

# Nina paid
splitwise expenses create "Groceries" 87.50 --paid-by "Nina"

# Different group
splitwise expenses create "Dinner" 120.00 --group "Rome"

# Different currency
splitwise expenses create "Dinner in Lisbon" 45.00 --group "Rome" --currency EUR

Other commands

splitwise me                          # Current user info
splitwise groups                      # List all groups
splitwise group "Dolores"             # Group details + member balances
splitwise friends                     # List friends
splitwise settle "Nina"               # Record a settlement
splitwise expenses delete 12345       # Delete an expense by ID

Output Modes

Every command supports:

• --json

  — raw JSON (for scripting or piping)

• --quiet

  — minimal output, just IDs/amounts

• --no-color

  — disable color (also respects

  NO_COLOR

  env var)

Patterns for Common Tasks

Log a recurring shared bill

Include the month in the description to avoid confusion:

splitwise expenses create "Xfinity Internet - March 2026" 51.30

Check before logging (avoid duplicates)

splitwise expenses list --after 2026-03-01 --limit 50 --json

Search the output for matching descriptions before creating.

Batch-log multiple expenses

Run multiple

splitwise expenses create

commands in sequence. No special syntax.

Error Handling

• "not logged in" → Run

  splitwise auth

  (needs browser for OAuth)
• "group not found" → Verify name with

  splitwise groups

• "friend not found" → Verify name with

  splitwise friends

• Network errors → Retry once, then report to user

Key Details

• Group/friend names use case-insensitive partial matching
• Default group (Dolores) means

  --group

  is optional for Barron & Nina expenses
• Amounts are USD by default (configurable via

  splitwise config set default_currency

  )

• --split even

  is the default — expense split equally among all group members
• The

  --paid-by

  flag defaults to the authenticated user (Barron)