Install

One command on macOS and Linux. One on Windows. No sudo, no package manager, no background daemon.

1. One-liner

macOS & Linux

curl -fsSL https://get.tetris.codes | sh

copy command

Windows (PowerShell)

irm https://get.tetris.codes/ps1 | iex

copy command

2. What the installer does

• Detects your OS and CPU architecture.
• Downloads the matching archive from releases.tetris.codes.
• Verifies the SHA-256 checksum before extracting.
• Installs the binary to ~/.local/bin/tetris (Unix) or %LOCALAPPDATA%\tetris\tetris.exe (Windows).
• Launches tetris onboard when run in an interactive terminal.

No sudo is required. No background service is installed. Nothing runs until you invoke it. Read the install script.

3. Manual install

Prefer the scripted one-liner — it verifies checksums for you. The direct archives are here if you want to install on a machine without shell access to the network, or pin to a specific version.

curl -fsSL https://releases.tetris.codes/latest/<archive> -o tetris.tar.gz
curl -fsSL https://releases.tetris.codes/latest/<archive>.sha256 -o tetris.tar.gz.sha256
sha256sum -c tetris.tar.gz.sha256          # or: shasum -a 256 -c on macOS
tar -xzf tetris.tar.gz
install -m 0755 tetris ~/.local/bin/tetris

4. PATH setup

If tetris --version prints “command not found” after install, ~/.local/bin isn't on your PATH yet:

# bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && . ~/.bashrc

# zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && . ~/.zshrc

# fish
fish_add_path ~/.local/bin

On Windows the installer puts the binary on PATH automatically via the user registry.

5. Verify it's working

tetris --version
tetris doctor

doctor inspects the binary, your license state, heartbeat freshness, and every assistant hook in one pass. Red lines tell you exactly what to run to fix them.

6. Wire into an assistant

The onboarding wizard handles this, but you can also do it by hand:

tetris install              # every detected assistant
tetris install claude-code  # Claude Code
tetris install codex        # OpenAI Codex CLI
tetris install cursor       # Cursor
tetris install claude-desktop

Full matrix of what works on which assistant, including settings-file locations and known limitations, lives on the platforms page.

7. Pinning a version

TETRIS_VERSION=v0.0.23 curl -fsSL https://get.tetris.codes | sh

Or set TETRIS_PREFIX to override the install directory. See the script for the full list of env vars.

8. Done.

Uninstalling is one command: tetris uninstall. Something broken? Start with troubleshooting or email us.