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
| Key | Action |
|---|---|
↑ / ↓ / j / k |
Move cursor |
1–9 |
Jump to session N |
Enter |
Attach to the selected session |
Y |
Open the yolo submenu |
A |
altergo launcher (project + account picker) |
X |
Kill the selected tmux session (asks to confirm) |
R |
Resume a previous conversation (cross-account session picker) |
N |
New tmux session |
C |
Toggle keep-awake / caffeinate (macOS only) |
S |
Settings |
Q |
Quit |
Yolo submenu (Y from main menu)
| Key | Action |
|---|---|
y |
yolo-new — pick project + account, launch with --yolo |
r |
yolo-resume-last — resume the last session with --yolo-resume |
p |
yolo-pick — cross-account session picker, launch with --yolo-resume <id> |
Esc / q |
Cancel |
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rover_tui-0.4.0.tar.gz.
File metadata
- Download URL: rover_tui-0.4.0.tar.gz
- Upload date:
- Size: 9.7 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0e290f3efa8ae073539f887030eb6e4b812b822367b4d06b2eb485939b133ee0
|
|
| MD5 |
b3f84d0a5de8f5019f9bd41a47165352
|
|
| BLAKE2b-256 |
593bfd9cbf15563282b0a1dac9eda048f899d3d484a461731e4fcc4aae63023b
|
Provenance
The following attestation bundles were made for rover_tui-0.4.0.tar.gz:
Publisher:
pypi-publish.yml on thepixelabs/rover
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rover_tui-0.4.0.tar.gz -
Subject digest:
0e290f3efa8ae073539f887030eb6e4b812b822367b4d06b2eb485939b133ee0 - Sigstore transparency entry: 1614107920
- Sigstore integration time:
-
Permalink:
thepixelabs/rover@71bbc085e506e25a2221b4fc79f9883f5fabe8b1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/thepixelabs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@71bbc085e506e25a2221b4fc79f9883f5fabe8b1 -
Trigger Event:
push
-
Statement type:
File details
Details for the file rover_tui-0.4.0-py3-none-any.whl.
File metadata
- Download URL: rover_tui-0.4.0-py3-none-any.whl
- Upload date:
- Size: 68.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2d4c38a5510eba91b0bd217b9cf3b4931853e7a5cf4e9cfd3f75495e0c37883f
|
|
| MD5 |
dcea606736d2f86f2d3834793a8f9a0f
|
|
| BLAKE2b-256 |
6c165498dd5daa23000199cf2325ec98d2f8c484d2d1d2ee56d50a8ebb14c93c
|
Provenance
The following attestation bundles were made for rover_tui-0.4.0-py3-none-any.whl:
Publisher:
pypi-publish.yml on thepixelabs/rover
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
rover_tui-0.4.0-py3-none-any.whl -
Subject digest:
2d4c38a5510eba91b0bd217b9cf3b4931853e7a5cf4e9cfd3f75495e0c37883f - Sigstore transparency entry: 1614107990
- Sigstore integration time:
-
Permalink:
thepixelabs/rover@71bbc085e506e25a2221b4fc79f9883f5fabe8b1 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/thepixelabs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@71bbc085e506e25a2221b4fc79f9883f5fabe8b1 -
Trigger Event:
push
-
Statement type:
