Rover

A terminal session manager — SSH in from your phone and manage tmux sessions and AI agents from anywhere.

Landing page: https://rover.pixelabs.net

What Rover is

Rover is an SSH-friendly TUI session manager for your Mac. Check, launch, or kill any AI coding agent from your phone in two keystrokes.

Prerequisites

• macOS or Linux (no Windows — use WSL)
• Python 3.11+
• tmux

Install

Homebrew (macOS, primary)

brew install thepixelabs/tap/rover

pipx (any platform with Python)

pipx install rover-tui

uv (modern pip alternative)

uv tool install rover-tui

Update

Homebrew

brew upgrade thepixelabs/tap/rover

pipx

pipx upgrade rover-tui

uv

uv tool upgrade rover-tui

Uninstall

Homebrew

brew uninstall thepixelabs/tap/rover

pipx

pipx uninstall rover-tui

uv

uv tool uninstall rover-tui

Quick start

After install, on the host that runs your agents:

rover

Pick a project, pick an altergo account, and tmux takes over. From a phone, SSH to the same host first:

ssh you@your-mac.local

Run rover — press ? for the keymap.

Auto-launch on SSH (optional)

Add to your shell's startup file so every SSH login drops straight into rover.

zsh — ~/.zshrc:

# auto-launch rover on SSH sessions
if [[ -n "$SSH_CONNECTION" ]] \
   && [[ -z "$TMUX" ]] \
   && [[ $- == *i* ]] \
   && command -v rover >/dev/null 2>&1; then
  exec rover
fi

bash — ~/.bash_profile (macOS) or ~/.bashrc (Linux):

# auto-launch rover on SSH sessions
if [[ -n "$SSH_CONNECTION" ]] \
   && [[ -z "$TMUX" ]] \
   && [[ $- == *i* ]] \
   && command -v rover >/dev/null 2>&1; then
  exec rover
fi

Guards: only fires over SSH, outside an existing tmux session, in interactive shells, and only when rover is on PATH.

Keymap

Main menu

Yolo submenu (Y from main menu)

Contributing

Issues and pull requests welcome at https://github.com/thepixelabs/rover.

License

See LICENSE.

Getting home — SSH connectivity

Need to establish an SSH path back to your Mac first? See docs/ssh-setup.md — covers Tailscale, router VPN (WireGuard / OpenVPN / IKEv2), and port forwarding with DDNS.