Get started
Install Sher, connect your account, and share your first terminal agent session.
Sher supports macOS 11 or newer on Intel and Apple Silicon. On Linux, it supports x86-64 and ARM64 systems with glibc 2.35 or newer.
Install Sher
Run the public installer:
curl -fsSL https://sher.ing/install | sh && export PATH="${CARGO_HOME:-$HOME/.cargo}/bin:$PATH"The installer detects your platform, downloads the latest stable release, verifies its archive and
checksum, and installs sher under $CARGO_HOME/bin or ~/.cargo/bin. It does not remove older
copies. Check which executable your shell will use:
which -a sher
sher --versionMore than one result from which -a sher?
Start a new shell, or run hash -r in Bash and rehash in Zsh. Confirm the managed binary is
first before renaming or removing an older source build.
Connect this machine
sher loginSher starts a device sign-in flow and prints the browser URL and code. The local machine stores a device token after you finish signing in. It never stores the S2 account credential used by Sher's server.
Open the session browser
Run Sher without arguments:
sherThe browser lists sessions in the current repository first. Press Tab to switch between this
repository, this device, and everything you have shared.
Share a session
Select a session and press s, or share the most recent session from the command line:
sher shareSher prints the link after the initial history uploads. The default audience comes from your repository or organization rule. Without a rule, the session starts as only me.
Keep links current
Install and start the background daemon:
sher daemon install
sher daemon start
sher daemon statusThe daemon watches for new session records and appends them to existing shares. A shared link can therefore keep following the same session without being created again.