relay

A modular terminal client that puts the services you actually use behind one menu, in one visual language. Each module documents its real capability ceiling — including what the provider's API will never allow.

Sibling to vitals: same shape, same documentation discipline, same refusal to render a fabricated zero where a real value is missing.

how it works

The interesting part is the research, and it lives in the README rather than a design doc, because several of the limits are hard ceilings rather than missing features. Spotify requires Premium twice over — once for transport control, and since February 2026 for the app owner’s account to hold a working client id at all. Discord will never expose a DM list or arbitrary history. YouTube caps at 100 searches a day and will not give up Watch Later or watch history. Each module’s source file records why, with the policy dates and the ToS language.

status

Two modules work, two are honest stubs. YouTube does search, a navigable result list, and audio playback through mpv, end to end. Browser lists Firefox tabs live from the session store, filters them, and opens one. Spotify and Discord report their capability ceiling and NeedsAuth rather than pretending. The architecture, config, theming, terminal handling, shared navigation widgets, mpv controller and auth skeleton are tested across 121 tests.