Install Writ

Install one command: writ. The installer selects the correct release. It checks the SHA-256 checksum before it replaces an existing binary.

macOS and Linux

1. Run this command:

   curl -fsSL https://writ.build/install.sh | sh

The installer writes the binary to $HOME/.local/bin by default. It prints a command when that directory is not in PATH. Run the printed command before you use Writ.

Windows

1. Open PowerShell.

2. Run this command:

   irm https://writ.build/install.ps1 | iex

The installer writes writ.exe to %LOCALAPPDATA%\Programs\writ\bin. It adds that directory to your user PATH.

You can use the shell installer from Git Bash. Use the PowerShell installer from PowerShell or Windows Terminal.

Supported systems

System	Processors	Installer
macOS	Intel and Apple silicon	install.sh
Linux	x86-64 and ARM64	install.sh
Windows	x86-64 and ARM64	install.ps1

Select a version or directory

The installer uses the latest stable release by default. Set WRIT_VERSION to install a specific release:

curl -fsSL https://writ.build/install.sh | WRIT_VERSION=v0.3.0 sh

Set WRIT_INSTALL_DIR to select another directory:

curl -fsSL https://writ.build/install.sh | WRIT_INSTALL_DIR="$HOME/bin" sh

Set the same environment variables before you run the PowerShell installer:

$env:WRIT_VERSION = "v0.3.0"
$env:WRIT_INSTALL_DIR = "$HOME\bin"
irm https://writ.build/install.ps1 | iex

The release page also contains the archives and checksums.txt.

Verify the installation

1. Run this command:

   writ --version

2. Make sure that the command prints a version.

Next

• Connect Writ to your agent.