Regret — the Bad Decisions terminal client
Regret is a dependency-free terminal client for Bad Decisions services. Its optional full-screen Peer Pressure interface uses Textual. The client contains no card corpus, runs on Linux, macOS, and Windows, and uses the free BytesAndCoffee-hosted service by default.
$ regret deal --packs coffee
I started by talking about workplace accommodations. Somehow the channel is now discussing one hell of a robustly deployed pastebin.
Install and try it
Homebrew is the recommended macOS and Linux path and installs man regret:
brew install bytesandcoffee/tap/regret
regret health
regret deal
Cross-platform pipx alternative:
pipx install bad-decisions-client
regret health
regret deal
Plain pip also works: python -m pip install bad-decisions-client.
regret doctor checks the installation, manual-page discovery, configuration,
and service compatibility without changing anything.
Native Windows ZIPs are attached to each GitHub release. They contain a
self-contained regret.exe, including the Peer Pressure TUI, and do not
require Python. WinGet and Chocolatey metadata are built from the same checked
release artifact; public package-manager listings are planned.
Use
regret --list-packs
regret deal --packs base,maha
regret provenance
regret provenance --json
regret doctor
Join an ephemeral multiplayer room with Peer Pressure:
regret together ohno --name Michael
No installation is required for the hosted browser table. It uses the same rooms and protocol as Regret; the room creator chooses the deck before joining, and later participants inherit that selection.
For the full-screen table, install the optional interface and add --tui:
pipx install 'bad-decisions-client[tui]'
regret together ohno --name Michael --tui
The TUI shows the table, scores, Responsible Adult, prompt, private hand, anonymous decisions, and round result in one continuously synchronized view. The ordinary line-oriented interface remains the dependency-free default. Both receive live state over authenticated Server-Sent Events while separate heartbeats maintain presence. The stream uses Python's standard library, so the line client needs no HTTP dependency. Homebrew installs the complete client, including the TUI.
The default endpoint is https://bytes.coffee/bad-decisions. Use --api-url
for another compatible deployment. Connection and API
failures return a non-zero status. See the 60-second guide
and multiplayer documentation.
Consequences and local state
Consequences is opt-in:
regret consequences status
regret consequences enjoy
regret consequences regret
The first interactive deal asks once when no preference exists; non-interactive
runs remain disabled. regret provenance reads the protected last-draw record
without contacting the API. Feedback is one mutable vote per eligible draw.
Use regret identity reset or regret identity off to control the optional
pseudonymous analytics identity. See Consequences.
Manual page
pipx links the page into ~/.local/share/man. A pyenv/asdf shim can hide a page
installed by pip; regret doctor prints the correct MANPATH fix. The generic
form is:
export MANPATH=":$(python3 -c 'import sys; print(sys.prefix)')/share/man"
Project links
1 maintainer
Metadata
1 maintainer
Release files for bad-decisions-client 2.3.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.3.0.tar.gz | 35.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bad_decisions_client-2.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 61.2 kB
Release files / bad_decisions_client-2.3.0.tar.gz
| Download URL | bad_decisions_client-2.3.0.tar.gz |
|---|---|
| Size | 35.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6c634b14009abde4856bee96ce0e97d01979b38fa8d62bba809548ade00a4c44
|
|
BLAKE2b-256 checksum How to use checksums |
885e7cd33b71a3bb88d3e03691b2cb66c6ce3421852d40a4e07ba2108aecd36d
|
| 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 Oct 1, 2026.
Transparency logRelease files / bad_decisions_client-2.3.0-py3-none-any.whl
| Download URL | bad_decisions_client-2.3.0-py3-none-any.whl |
|---|---|
| Size | 25.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2f2951947ad7aa7a12601436ec116c6fe8fc0c62da7d06074448d8898c1de67
|
|
BLAKE2b-256 checksum How to use checksums |
d02e2d8ee1842e9a5c36d0e51cd59215a695132dca9d8798fa43ec72ee3351b4
|
| 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 Oct 1, 2026.
Transparency log
