Session browser
Find, inspect, share, and manage terminal agent sessions from Sher's keyboard interface.
Run sher without arguments to open the terminal interface. It starts in the current repository
when Sher can identify one.
Move between scopes
Press Tab to move through three views:
- This repository shows sessions associated with the repository under your shell.
- This device shows indexed sessions across the machine.
- Shared shows sessions that already have Sher links.
The table prioritizes the session title, harness, model, message count, repository and branch, last activity, and share state. The subagent count appears on wider terminals when at least one visible session has nested work.
Keyboard reference
| Key | Action |
|---|---|
j / k or ↑ / ↓ | Move through sessions. |
g / G | Jump to the first or last row. |
Enter | Open the selected session. |
Esc | Return to the list. |
Tab | Change scope. |
/ | Search titles, repositories, branches, harnesses, and paths. |
s | Share, change the audience, or unshare. |
f | Filter repositories and manage sync rules. |
y / o | Copy or open the current link. |
d | Start the daemon. |
l | Sign in or sign out. |
M | Rename this machine. |
r | Rescan agent session roots. |
m | Change the transcript view between chat, thinking, and all. |
x | Expand or clamp long transcript text. |
? / q | Open help or quit. |
Read the share state
| State | Meaning |
|---|---|
| Not shared | The session has no link and no rule is waiting to share it. |
| Queued | A rule selected the session and the daemon has not uploaded it yet. |
| Shared | Every currently indexed record is uploaded. |
| Uploading | Local records remain and acknowledgements are arriving. |
| Stale | Local records remain, no recent progress is visible, and the daemon is stopped. |
| Live | A writer is attached and appending now. |
| Unshared | The remote share was deleted. |
The footer shows device-wide progress as synced sessions, sessions selected for sync, and all local sessions. New activity can make a previously synced session fall behind until the daemon catches up.