Bridge

wer bridge is werkr's built-in text user interface (TUI) for interactively managing your workstations, configurations, and SSH keys. The experience is inspired by k9s.

Launching

wer bridge

Views

The bridge organizes resources into three views, each accessible with a number key:

  • 1 - Workstations - See all workstations, their status, provider, and IP. Start, stop, restart, shell in, or connect via tmux directly from the list.
  • 2 - Configurations - View all WorkstationConfigs and which workstations they match. Edit or delete configurations.
  • 3 - SSH Keys - View all SSH keys, their paths, and selectors. Edit or delete keys.

Navigation

The bridge uses vim-style navigation and single-key shortcuts for common operations:

  • 1 / 2 / 3 - Switch to Workstations / Configs / SSH Keys view
  • j / k or arrow keys - Navigate up and down
  • g / G - Jump to top or bottom
  • Enter - SSH into the selected workstation
  • t - Connect via tmux
  • s - Start workstation
  • S - Stop workstation
  • r - Restart workstation
  • e - Edit selected resource
  • d - Delete selected resource
  • R - Manual refresh
  • q - Quit

Details Panel

The bridge shows a details panel for the selected resource, displaying its full configuration and current status. This gives you a quick overview without needing to run separate wer get commands.

Options

# Custom refresh interval (default: 5 seconds)
wer bridge --refresh 2

# Set a color theme
wer bridge --theme dark

Available themes: auto (default), dark, light, basic.

Worker

The bridge is a user interface - the actual reconciliation (creating VMs, applying configurations, etc.) is performed by the background worker. The worker starts automatically on macOS when werkr is installed. On Linux and Windows, start it with: 

wer worker start

Next Steps

See the full CLI reference for wer bridge for all key bindings and options.