CLI reference

Run sher --help for the command list installed on your machine.

Browse sessions

sher
sher sessions [--repo owner/name] [--all] [--json] [--limit N]

sher opens the keyboard interface. sher sessions prints sessions with the newest activity first. Use --all to include nested sessions, incomplete sources, and other indexed residue.

Share and remove links

sher share [path] [--repo owner/name] [--recent N] [--live] [--dry-run]
sher unshare [--repo owner/name] [--recent N] [--yes]
sher status [--json] [--prune]

sher share chooses the most recent session by default. --recent 2 chooses the next one. --live stays attached to one session, and --dry-run reports what would upload without changing anything.

sher unshare deletes the remote link while leaving local files intact. sher status --prune forgets local records for shares the server confirms were deleted.

Automatic sync

sher sync
sher sync on <organization|owner/repository> [--history]
sher sync off <organization|owner/repository>
sher sync device on|off

sher sync lists account rules. Scope rules follow your account to every machine. Device sync is local to one machine and always shares privately.

Daemon

sher daemon [--once]
sher daemon install|uninstall|start|stop|status

--once scans and reconciles one time. install registers Sher with launchd on macOS or a systemd user unit on Linux. Registration and running state are separate, so a registered daemon can remain stopped.

Account

sher login [--origin URL]
sher logout

sher login uses https://sher.ing unless SHER_ORIGIN or the saved configuration selects another server. sher logout revokes this device when possible and removes its local token.

Version and updates

sher --version [--json]
sher update [--check] [--channel stable|dev]

Ordinary Sher commands do not make update requests. sher update --check reports an available version without downloading or replacing the executable. Read Upgrade Sher safely before changing channels or recovering a failed update.