meadows-tui
MEADOWS terminal UI client: a curses-based TUI chat client for MEADOWS. Uses click for CLI argument parsing and curses for the terminal interface. Connects directly to meadows-server via Socket.IO using meadows-client.
What this package contains
cli.py— Click entry point with env-var supportapp.py— Curses-based terminal app with dark/light theme, keybindings, auth flowscreens/auth_screen.py— JWT token paste or local secret authscreens/chat_screen.py— Main chat: messages, sidebar, inputwidgets/message_widget.py— Message rendering with quotes, reactionswidgets/input_widget.py— Chat input with reply quote previewwidgets/sidebar_widget.py— Groups, users, and bots panelsclient_bridge.py— Adapts MeadowClient events to curses-compatible messagesthemes.py— Dark and light color definitions (mapped to curses colors)config.py— Configuration dataclass
Install
uv pip install -e ".[dev]"
Run
# With a JWT token
MEADOWS_JWT=eyJ... meadows-tui
# Or with a shared secret
MEADOWS_JWT_SECRET=secret MEADOWS_USERNAME=alice meadows-tui
# Or specify server explicitly
meadows-tui --server http://chat.example.com:8080 --token eyJ...
CLI Options
| Option | Env Var | Default | Description |
|---|---|---|---|
--server |
MEADOWS_SERVER_URL |
http://localhost:8080 |
Socket.IO server URL |
--token |
MEADOWS_JWT |
— | JWT token (pasted) |
--jwt-secret |
MEADOWS_JWT_SECRET |
— | Secret for local token gen |
--username |
MEADOWS_USERNAME |
— | Username for local token gen |
--theme |
MEADOWS_THEME |
auto |
dark, light, or auto |
--log-level |
MEADOWS_LOG_LEVEL |
WARNING |
DEBUG, INFO, WARNING, ERROR |
Keybindings
| Key | Action |
|---|---|
Ctrl+t |
Toggle dark/light theme |
Ctrl+b |
Toggle sidebar |
Ctrl+n |
Focus input |
Ctrl+g |
Focus groups list |
Ctrl+q |
Quit |
Architecture invariants
- Protocol constants only. The only import from
meadows.protocolisEventName(in__init__.py). - Transport via meadows-client. No raw Socket.IO usage; all transport goes through
MeadowClient. - Event bridge. Socket.IO events from the server are translated to curses-compatible messages in
client_bridge.py. - Theme support. Dark/light modes with terminal-appropriate colors (mapped to curses color constants), toggleable at runtime.
- PEP 420 namespace.
src/meadows/tui/__init__.pyexists; there is NOsrc/meadows/__init__.py.
Configuration (env vars)
| variable | default | purpose |
|---|---|---|
MEADOWS_SERVER_URL |
http://localhost:8080 |
server URL for Socket.IO |
MEADOWS_JWT |
— | pre-encoded JWT token |
MEADOWS_JWT_SECRET |
— | JWT secret for local token generation |
MEADOWS_USERNAME |
— | username when using JWT secret |
MEADOWS_THEME |
auto |
color theme choice |
MEADOWS_LOG_LEVEL |
WARNING |
logging verbosity |
MEADOWS_SYSTEM_NAME |
MEADOWS Chat |
display name |
Development
uv pip install -e ".[dev]"
uv pip install edwh
uv run edwh local.setup # check/ensure env vars
uv run edwh local.test # uv run pytest -q
uv run edwh local.lint # uv run ruff check src tests
uv run edwh local.fmt # uv run ruff format src tests && ruff check --fix src tests
Features
- Multi-group chat with sidebar navigation
- Message send/receive with typing indicators
- Dark and light color themes (toggle at runtime)
- Collapsible sidebar
- Emoji reactions (quick pick from 9 emojis)
- Reply to messages (quote preview)
- Message removal
- User and bot lists per group
- JWT authentication (pasted token or local secret)
- Auto-connect via env vars
Metadata
Release files for meadows-tui 0.1.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 | Provenance | Actions |
|---|---|---|---|---|
| meadows_tui-0.1.0.tar.gz | 96.1 kB | Without provenance | Details for meadows_tui-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| meadows_tui-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for meadows_tui-0.1.0-py3-none-any.whl |
Total release size: 112.4 kB
Release files / meadows_tui-0.1.0.tar.gz
| Download URL | meadows_tui-0.1.0.tar.gz |
|---|---|
| Size | 96.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a693e4aa4b53114668a57615954439fbc80d1fab03bf7e03f7937f57af527db2
|
|
BLAKE2b-256 checksum How to use checksums |
bf8746fececcfd76cc396f1556ec60eb2314d540568448225980663b5edfc436
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / meadows_tui-0.1.0-py3-none-any.whl
| Download URL | meadows_tui-0.1.0-py3-none-any.whl |
|---|---|
| Size | 16.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
007f3df545a581e70bc7a1f18e17fcb94fe507bc4b7468aec39976ca9472c9c5
|
|
BLAKE2b-256 checksum How to use checksums |
5f6626e61a2175d8ac80544d2db5394e088227c1470a2ad774a2dfbcbc816649
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.15 {"installer":{"name":"uv","version":"0.9.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Linux Mint","version":"22.3","id":"zena","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for meadows-tui 0.1.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.