ivo.zilkenat
  • Joined on 2025-10-29

schnorrer-cli (1.0.0)

Published 2026-03-19 16:42:10 +00:00 by ivo.zilkenat

Installation

pip install --index-url  --extra-index-url https://pypi.org/ schnorrer-cli

About this package

CLI for Schnorrer expense-splitting app

schnorrer-cli

CLI for the Schnorrer expense-splitting app.

Installation

pip install schnorrer-cli
# or
pipx install schnorrer-cli
# or
uv tool install schnorrer-cli

First-run setup

On first use, the CLI prompts for your deployment URL and API key:

$ schnorrer groups list
No configuration found. Let's set up your Schnorrer CLI.

You'll need:
  1. Your Convex deployment URL (from Settings or browser URL)
  2. An API key (Settings → API Keys → Generate)

Deployment URL: https://your-deployment.convex.site
API Key: ********

Configuration saved to ~/.config/schnorrer/config.toml

Or configure explicitly:

schnorrer auth login --url https://your-deployment.convex.site --key YOUR_API_KEY

Environment variables SCHNORRER_URL and SCHNORRER_TOKEN override the config file.

Usage

schnorrer groups list
schnorrer groups create --name "Trip to Berlin" --currency EUR
schnorrer groups members --group <groupId>

schnorrer expenses list --group <groupId>
schnorrer expenses add --group <groupId> --amount 5000 --currency EUR \
  --description "Dinner" --category food --payer <memberId> \
  --split equal --participants <id1>,<id2>,<id3>
schnorrer expenses detail --group <groupId> --expense <expenseId>

schnorrer balances --group <groupId>

schnorrer settlements list --group <groupId>
schnorrer settlements add --group <groupId> --payer <id> --recipient <id> \
  --amount 2500 --currency EUR

schnorrer admin seed-rates

All commands support --json for machine-readable output.

Configuration

Config stored at ~/.config/schnorrer/config.toml (0600 permissions).

Env var Config key Description
SCHNORRER_URL deployment_url Convex deployment URL
SCHNORRER_TOKEN api_key API key

Requirements

Requires Python: >=3.11
Details
PyPI
2026-03-19 16:42:10 +00:00
7
32 KiB
Assets (2)
Versions (5) View all
1.3.1 2026-03-24
1.3.0 2026-03-23
1.2.0 2026-03-23
1.1.0 2026-03-19
1.0.0 2026-03-19