residual/auth
=============

authentication, login screen, and session selection for residual.
requires CGO (linux only) for PAM support.

packages:
  auth/        shared authentication interfaces and PAM conversation helpers.
  auth/login/  bubbletea login screen UI (branding + PAM conversation).
  auth/selector/ bubbletea session picker UI (.desktop file scanning).
  auth/tty/    linux TTY management — open, VT switching, wait-active.

binary:
  res-login   full auth stack: TTY setup → PAM auth → session launch.
              run as root for the full login flow.
              run as non-root for standalone session selection only.
              requires CGO_ENABLED=1 (linux only).
              see core/etc/pam.d/residual-login for the PAM service file.

config:
  /etc/residual/login.toml
  ~/.config/residual/login.toml

build:
  go build ./cmd/res-login

module:   git.merith.xyz/residual/auth
requires: git.merith.xyz/residual/core