2025-11-26 18:00:23 +01:00
|
|
|
|
# tmux helpers (relay backgrounding)
|
|
|
|
|
|
|
|
|
|
|
|
## Why we ship tmux helpers
|
|
|
|
|
|
- Run the relay detached so your shell can close, while keeping an interactive pane you can reattach to.
|
|
|
|
|
|
- Provide a consistent start/attach workflow without adding a daemon mode or external process manager.
|
|
|
|
|
|
- Keep the relay code itself tmux-agnostic; tmux is only a launcher concern.
|
|
|
|
|
|
|
|
|
|
|
|
## Commands
|
|
|
|
|
|
- `warelay relay:tmux` — restarts the `warelay-relay` session running `pnpm warelay relay --verbose`, then attaches (skips attach when stdout isn’t a TTY).
|
|
|
|
|
|
- `warelay relay:tmux:attach` — attach to the existing session without restarting it.
|
2025-12-05 17:50:02 +00:00
|
|
|
|
- `warelay relay:heartbeat:tmux` — same as `relay:tmux` but adds `--heartbeat-now` so Pi is pinged immediately on startup.
|
2025-11-26 18:00:23 +01:00
|
|
|
|
|
|
|
|
|
|
All helpers use the fixed session name `warelay-relay`.
|
|
|
|
|
|
|
|
|
|
|
|
## Logs
|
|
|
|
|
|
- The relay always writes to the configured file logger (defaults to `/tmp/warelay/warelay.log`); on start it prints the active log path and level.
|
|
|
|
|
|
- tmux is just for interactive viewing; you can also tail the log file or use another supervisor if you prefer.
|
