Uninstall

One command unwires every assistant. The binary and your local data stay on disk by default so a reinstall picks up where you left off. Delete them explicitly to fully walk away.

1. Unwire every assistant

tetris uninstall

Iterates every detected assistant (Claude Code, Codex, Gemini, Aider, Cline, Continue, Windsurf, Cursor, Agent SDK) and restores the settings file from the backup taken at install time. If the backup is gone, the hook entries are stripped in place.

Kept any post-install edits you don’t want to lose? Add --no-restore:

tetris uninstall --no-restore

That strips only the Tetris hook entries, leaving the rest of your settings file untouched.

2. What stays, what goes

Item	Where	After `tetris uninstall`
Assistant hook entries	`~/.claude/settings.json`, `~/.codex/config.toml`, `~/.gemini/settings.json`, …	removed (or restored from backup)
`tetris` binary	`~/.local/bin/tetris` or `%LOCALAPPDATA%\tetris\tetris.exe`	kept
License, ledger, install ID	`~/.tetris/` or `$TETRIS_DATA_DIR`	kept

3. Delete the binary

Once the hooks are unwired, remove the binary itself:

# macOS and Linux
rm ~/.local/bin/tetris

# Windows (PowerShell)
Remove-Item -Recurse -Force $env:LOCALAPPDATA\tetris

4. Delete local data

Only do this if you’re sure you’re done. It removes your license key, the session ledger (your lifetime savings history), and the install ID used for license-device counting.

# macOS and Linux
rm -rf ~/.tetris

# Or wherever you set TETRIS_DATA_DIR

On macOS the default data directory is ~/Library/Application Support/tetris; on Linux it’s ~/.local/share/tetris.

5. Manual uninstall

If tetris is gone but your assistant still calls it, remove the hook entries by hand. Look for any entry whose command is tetris compress (or contains the string tetris):

Assistant	Settings file	Key to remove
Claude Code	`~/.claude/settings.json`	`hooks.PreToolUse[*]`
Codex CLI	`~/.codex/config.toml`	`[[hooks.pre_tool_use]]` blocks
Gemini CLI	`~/.gemini/settings.json`	`hooks.preToolUse[*]`
Aider	`~/.aider.conf.yml`	`pre_send` command
Cline / Continue / Windsurf / Cursor	IDE settings	extension-specific pre-prompt hook

6. Privacy

Nothing is created or destroyed on our servers when you uninstall. The heartbeat just stops arriving; the install row is marked inactive after 30 days. There is no “delete me” endpoint to call, because there’s nothing to delete beyond the pseudonymous install ID we already keep per the privacy policy.

7. Tell us why

Optional, appreciated, and the thing that actually changes the product. One line to bye@tetris.codes is enough. No form, no survey.