CLI Installation

The Sprites CLI (sprite) is available for macOS, Linux, and Windows.

Quick Install (Recommended)

The easiest way to install the CLI is with our install script:

curl -fsSL https://sprites.dev/install.sh | sh

The install script automatically:

• Detects your operating system and architecture
• Downloads the latest release binary
• Verifies the SHA256 checksum
• Installs to ~/.local/bin

After installation, you may need to add ~/.local/bin to your PATH if it’s not already included. The script will provide instructions if needed.

Manual Installation

Latest release: v0.0.1-rc30

macOS

Apple SiliconIntel

Linux

x86-64ARM64

Windows

x86-64ARM64

Download the binary

curl -LO https://sprites-binaries.t3.storage.dev/client/v0.0.1-rc30/sprite-darwin-arm64.tar.gz

Verify checksum (recommended)

curl -LO https://sprites-binaries.t3.storage.dev/client/v0.0.1-rc30/sprite-darwin-arm64.tar.gz.sha256
shasum -a 256 -c sprite-darwin-arm64.tar.gz.sha256

Extract and install

tar xzf sprite-darwin-arm64.tar.gz
sudo mv sprite /usr/local/bin/

For Intel Macs, replace "arm64" with "amd64" in the URLs above.

Download the binary

curl -LO https://sprites-binaries.t3.storage.dev/client/v0.0.1-rc30/sprite-linux-amd64.tar.gz

Verify checksum (recommended)

curl -LO https://sprites-binaries.t3.storage.dev/client/v0.0.1-rc30/sprite-linux-amd64.tar.gz.sha256
sha256sum -c sprite-linux-amd64.tar.gz.sha256

Extract and install

tar xzf sprite-linux-amd64.tar.gz
sudo mv sprite /usr/local/bin/

For ARM64, replace "amd64" with "arm64" in the URLs above.

Download the binary

Invoke-WebRequest -Uri "https://sprites-binaries.t3.storage.dev/client/v0.0.1-rc30/sprite-windows-amd64.zip" -OutFile "sprite-windows-amd64.zip"

Extract to your bin directory

Expand-Archive sprite-windows-amd64.zip -DestinationPath $env:USERPROFILE\bin

Add to PATH (run as Administrator)

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\bin", "User")

For ARM64 Windows, replace "amd64" with "arm64" in the URL above.

Verify Installation

sprite --help

You should see the help output with available commands.

Upgrading

If you installed from the direct download links, upgrade to the latest version:

sprite upgrade

To check for updates without installing:

sprite upgrade --check

Configuration

The CLI stores configuration in ~/.sprites/sprites.json. This includes:

• Organization tokens
• Current organization selection
• Current sprite selection

Config File Location

Platform	Location
macOS/Linux	~/.sprites/sprites.json
Windows	%USERPROFILE%\.sprites\sprites.json

Note: config.json is kept for backward compatibility with older clients, but current versions read/write sprites.json.

Optional: Local Directory Context

The CLI supports a .sprite file in your project directory to remember which sprite to use:

# Set the sprite for current directory
sprite use my-project-sprite

This creates a .sprite file that the CLI reads automatically. Add .sprite to your .gitignore as it’s user-specific.

Optional: Mount Helper Function

Add this function to your shell configuration (~/.zshrc or ~/.bashrc) to easily mount your Sprite’s filesystem locally:

sc() {
  local sprite_name="${1:-$(sprite use)}"
  local mount_point="/tmp/sprite-${sprite_name}"
  mkdir -p "$mount_point"
  sshfs -o reconnect,ServerAliveInterval=15,ServerAliveCountMax=3 \
    "sprite@${sprite_name}.sprites.dev:" "$mount_point"
  cd "$mount_point"
}

Usage:

sc my-sprite  # Mount and cd to sprite's home directory

This requires sshfs to be installed. On macOS, install with brew install macfuse sshfs. On Linux, use your package manager: apt install sshfs or yum install fuse-sshfs.

Troubleshooting

Permission Denied

If you get a permission denied error on macOS or Linux:

chmod +x sprite
sudo mv sprite /usr/local/bin/

Command Not Found

Ensure the binary is in your PATH:

# Check if sprite is in PATH
which sprite

# If not, add /usr/local/bin to PATH
export PATH="/usr/local/bin:$PATH"

macOS Security Warning

On macOS, you may see a security warning when first running the CLI. To allow it:

1. Open System Preferences > Security & Privacy
2. Click “Allow Anyway” next to the message about sprite
3. Run sprite again and click “Open”

Or use the command line:

xattr -d com.apple.quarantine /usr/local/bin/sprite

Next Steps

Authentication

Set up your Fly.io account and manage tokens

Commands Reference

Full CLI documentation and examples