Block a user
schnorrer-cli (1.2.0)
Published 2026-03-23 20:20:39 +00:00 by ivo.zilkenat
Installation
pip install --index-url --extra-index-url https://pypi.org/ schnorrer-cliAbout 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 or email> \
--split equal --participants <id1 or email>,<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 or email> --recipient <id or email> \
--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
2026-03-23 20:20:39 +00:00
Assets (2)
Versions (5)
View all
PyPI
8
45 KiB