install

PairSpaces CLI Installer

The PairSpaces CLI lets you interact with PairSpaces from your terminal. This guide shows how to install or uninstall the PairSpaces CLI for macOS, Linux, and Windows.

Installation

macOS / Linux / Windows (WSL)

curl -fsSL https://get.pairspaces.io/install.sh | bash

Optional flags:

• -u: Install to your user bin directory (~/.local/bin on Linux, ~/bin on macOS)
• -d <dir>: Install to a specific directory

curl -fsSL https://get.pairspaces.io/install.sh | bash -s -- -u

Windows (PowerShell)

irm https://get.pairspaces.io/install.ps1 | iex

Uninstalling PairSpaces CLI

macOS / Linux / Windows (WSL)

curl -fsSL https://get.pairspaces.io/install.sh | bash -s -- --uninstall

Windows (PowerShell)

> $script = Invoke-RestMethod https://get.pairspaces.io/install.ps1
> & ([scriptblock]::Create($script)) -Uninstall

Testing Installation

pair help

Tests

Linux, macOS

We use Bats to test the installation script:

bats tests/install.bats

Windows

We use Pester to test the installation script. To ensure tests use Pester v5, configure your $PROFILE:

# Clean out legacy module roots (prevents Pester 3.4 autoload)
$paths = $env:PSModulePath -split ';' | Where-Object {
    $_ -notlike '*WindowsPowerShell*' -and $_ -notlike '*v1.0*'
}
$env:PSModulePath = ($paths -join ';')

# Force Pester 5
Remove-Module Pester -ErrorAction SilentlyContinue
Import-Module "$HOME\Documents\PowerShell\Modules\Pester\5.7.1\Pester.psd1" -Force

Invoke-Pester -CI

Requirements

• macOS/Linux: curl, bash
• Windows: PowerShell 5.0+

Support

Need help? Email support [at] pairspaces [dot] com.