Install
Install
Section titled “Install”curl --proto '=https' --tlsv1.2 -LsSf https://github.com/CascadingLabs/Yosoi/releases/latest/download/install.sh -o install-yosoi.sh
sh install-yosoi.sh
To install a specific version, pass --version to the downloaded script:
sh install-yosoi.sh --version 0.4.0
Supports x86-64 and ARM64 with glibc 2.39 or newer, such as Ubuntu 24.04.
Installs in ~/.local/bin. Add that directory to your PATH if the installer asks you to.
uv tool install yosoi-cli
Installs a prebuilt executable. Rust and Cargo are not required.
To install a specific version:
uv tool install yosoi-cli==0.4.0
To run a command without installing the tool permanently:
uvx --from yosoi-cli yosoi --help
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/CascadingLabs/Yosoi/releases/latest/download/install.sh -o install-yosoi.sh
sh install-yosoi.sh
To install a specific version, pass --version to the downloaded script:
sh install-yosoi.sh --version 0.4.0
Supports Apple Silicon and Intel Macs on macOS 11.0 or newer.
Installs in ~/.local/bin. Add that directory to your PATH if the installer asks you to.
Windows
Section titled “Windows”Invoke-WebRequest https://github.com/CascadingLabs/Yosoi/releases/latest/download/install.ps1 -OutFile install-yosoi.ps1
& ./install-yosoi.ps1
To install a specific version, pass -Version to the downloaded script:
& ./install-yosoi.ps1 -Version 0.4.0
Supports Windows x86-64. Installs in $env:LOCALAPPDATA\Yosoi\bin and adds it to your PATH.
Open a new terminal to refresh other sessions.
cargo install yosoi --features cli --locked
Builds from source. Requires Rust 1.99 or newer and native build dependencies for your platform.
To install a specific version:
cargo install yosoi --features cli --locked --version '=0.4.0'
Verification
Section titled “Verification”yosoi --version
See Update and uninstall to maintain your installation.
Use Surface for persistent JSON-lines sessions, bounded web/video reads, live web actions, and archived replay.