Bad Decisions terminal client
bad-decisions-client is a dependency-free terminal client for a Bad
Decisions service. It contains no card corpus and runs on Linux, macOS, and
Windows.
Install
On macOS and Linux, Homebrew is the suggested install. It also sets up
man regret with no shell changes:
brew install bytesandcoffee/tap/regret
Otherwise use pipx, which keeps regret in its own environment and also links its manual page, or plain pip:
pipx install bad-decisions-client
python -m pip install bad-decisions-client
regret doctor checks an install and prints the fix for anything wrong,
without changing anything. For example, with pyenv or another version manager
that puts shims on PATH, man regret cannot find the page pip installed, and
doctor prints the MANPATH line to add to your shell profile.
Use
regret health
regret deal
regret deal --packs base,maha
regret provenance
regret provenance --json
regret --list-packs
regret doctor
Join an ephemeral multiplayer room with Peer Pressure:
regret together ohno --name Michael
The first participant is the initial Responsible Adult. Regret securely caches the room-local reconnect capability, maintains heartbeats while connected, and automatically resynchronizes stale state. Peer Pressure identity is separate from Consequences analytics identity. See the multiplayer documentation.
Consequences is opt-in and disabled until you choose:
regret consequences status
regret consequences enjoy
regret consequences regret
The first interactive deal prompts once when no preference is stored; non-interactive runs remain disabled. When enabled, voting and its pseudonymous telemetry are available. The client also performs a cached, best-effort daily check against the configured API version.
regret provenance prints the licenses, attribution, versions, and source
records for every pack represented in the last locally saved draw. It does not
make a network request. A successful draw with provenance replaces the saved
record; feedback capability details are retained only when that same draw is
eligible for voting.
The default endpoint is https://bytes.coffee/bad-decisions. Use --api-url
for another compatible deployment. Connection and API failures return a
non-zero exit status.
Changelog
See CHANGELOG.md for client release notes.
Release
Build and validate before uploading a new immutable PyPI version:
cd client
python -m build
twine check dist/*
1 maintainer
Metadata
1 maintainer
Release files for bad-decisions-client 2.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bad_decisions_client-2.0.0.tar.gz | 21.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bad_decisions_client-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 38.7 kB
Release files / bad_decisions_client-2.0.0.tar.gz
| Download URL | bad_decisions_client-2.0.0.tar.gz |
|---|---|
| Size | 21.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1c86192d3e891c9e41eadf93dd40bf540e0d87da9f50127e333bb5a0131ae6c2
|
|
BLAKE2b-256 checksum How to use checksums |
6069a4e9e0f37efcb31610867691e222de29c20f747cf5b10b70a62a6c3cc172
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency logRelease files / bad_decisions_client-2.0.0-py3-none-any.whl
| Download URL | bad_decisions_client-2.0.0-py3-none-any.whl |
|---|---|
| Size | 17.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
55afb79c17af2cab8f0b69085c908b6ef34890fa8020eb17b44d21ed0b285df1
|
|
BLAKE2b-256 checksum How to use checksums |
0d90cb70fcb73d5ba4ef9de4316d99924e403a17dd84e9685203b0299ad2621b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 28, 2026.
Transparency log
