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. Claude Desktop (.mcpb plugin)

Claude Desktop uses the Anthropic-native .mcpb extension path. The curl one-liner refreshes the local Tetris Desktop extension when Claude has already created its config folder; otherwise it stages and opens the bundle so you can click Install.

Linux: Claude Desktop has no Linux build; use the curl installer.

1. 1. Download the .mcpb for your platform.
2. 2. Double-click the file. Claude Desktop opens an install dialog.
3. 3. Click Install, then fully quit and reopen Claude Desktop.

Prefer the GitHub release page? View all assets on GitHub.

5. 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.

6. 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.

7. Wire into an assistant

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

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

Existing users can rerun the one-line installer or run tetris install --migrate-existing. It repairs old Tetris hook files and Claude Desktop raw-MCP entries without first-time wiring untouched assistants.

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

8. 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.

9. Done.

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