latchd/docs/ui.md

Latchd user interface

Latchd starts on a virtual terminal. The interface keeps the session list and the login fields visible at the same time.

The screenshot comes from the Docker test image. It uses preview mode. Preview mode does not contact PAM or start a user session.

Help panel

Press ? to show the key reference.

Use the following keys:

• Press Tab or Shift-Tab to move focus.
• Press the arrow keys to choose a session.
• Press / to filter sessions or accounts.
• Press Ctrl-N or Ctrl-P to change the account.
• Press Ctrl-R to refresh account and session discovery.
• Press Ctrl-B to toggle the background.
• Press Ctrl-M to toggle reduced motion.
• Press Enter to authenticate.
• Press Esc to clear the password or close the help panel.
• Press Ctrl-C to restore the terminal and quit.

These messages show account state before login. PAM accepts or rejects the login.

Capture method

The capture uses a Docker PTY and the release binary from latchd-test:local:

tmux new-session -d -x 120 -y 36 \
  'docker run --rm -it latchd-test:local /workspace/target/release/latchd --preview --no-log'

The image in this directory contains the plain terminal capture. It does not show a host VT, a host compositor, or a real PAM login.