Warpeer is built for work that keeps running on a server while you are away. It finds your tmux and Herdr sessions and puts you back inside them.
Choose a session when you connect
When you connect to a host, Warpeer looks for tmux and Herdr sessions on that server and lists them. Each row shows the runtime, the session name, when it was created or last active, and the coding agent running in it.
- Tap a session to attach to it.
- Choose Select Multiple Sessions, tap several, then open them together as separate tabs.
- Choose Continue in Shell to skip attaching and use a plain login shell.
- Use Close Session to end a session you no longer need.
The Sessions tab
The Sessions tab shows every open terminal as a card with a live preview of its screen, so you can see what is happening without opening it. A card also shows the coding agent state and, inside a git repository, the number of added and removed lines. Tap a card to continue, the chart button to open its session probe, or the close button to end it.
Below your open sessions, Connected Sessions lists hosts you used recently. Tap one to reconnect with the same saved credential.
Move between terminals
Each session opens as a tab. Swipe sideways across the terminal to move to the next or previous tab. A short label names the session and host you landed on. Going back to the Sessions tab keeps your terminals open in the background of the app.
Coming back to the app
iOS suspends apps that are not on screen. When you return, Warpeer checks each connection and reconnects the ones the system closed. If a connection still cannot be restored, the tab keeps its last screen and shows Connection lost with a Reconnect button, which attaches the same tmux or Herdr session again. Your work never stopped, because it was running on the server the whole time.
Two settings in Settings control this:
- Keep Alive sets how often Warpeer sends SSH keep-alive packets.
- The background time limit asks iOS to keep connections open for System Default, 5, 10, 15 or 30 minutes after you leave. iOS decides how much time the app actually gets.
Warpeer installs a small helper on the server to find sessions. See The remote helper.