Platforms

Every coding assistant tetris ships support for today. Detection is directory-based — tetris looks for the assistant’s config directory under $HOME and installs its hook there. Nothing touches /etc, nothing runs as root.

This table is sourced from crates/tetris-cli/src/install/ in the binary you’re running. If your assistant is missing, email us with the config file path — it’s usually a two-day turnaround.

Supported assistants

Assistant Install command Settings file Hook mechanism
Claude Code tetris install claude ~/.claude/settings.json PreToolUse hook, routes Edit/MultiEdit/Write/NotebookEdit
Codex CLI tetris install codex ~/.codex/config.toml pre_tool_use hook
Cursor tetris install cursor ~/.cursor/ (project-level .cursorrules) Context-preamble injection
Gemini CLI tetris install gemini ~/.gemini/settings.json preToolUse hook
OpenCode tetris install opencode ~/.opencode/config.json Pre-prompt filter
Aider tetris install aider ~/.aider.conf.yml pre_send command
Factory Droid tetris install factory_droid ~/.factory/ Agent pre-hook
Trae tetris install trae ~/.trae/ Agent pre-hook
Antigravity tetris install antigravity ~/.antigravity/ Agent pre-hook
Hermes tetris install hermes ~/.hermes/ Agent pre-hook
GitHub Copilot tetris install copilot Copilot CLI config Pre-prompt filter

Install everything at once

tetris install --all

Only wires assistants that are actually detected on the current machine. Safe to re-run.

What gets written

For every assistant, tetris takes a timestamped backup of the settings file before editing it. The backup lives under ~/.tetris/backups/<assistant>/. tetris uninstall restores the most recent backup; pass --no-restore to strip hook entries in place instead.

What doesn’t compress

Tool calls whose payload is not text — image data, binary blobs, base64 pastes — pass through unchanged. Tetris detects non-text content and emits “allow with no change” rather than risk corrupting the input.

Known limitations

Something missing?

If your assistant isn’t on this list but it has a documented pre-prompt or pre-tool hook, email the hook spec to help@tetris.codes with a link to the assistant’s docs. Adding an adapter is usually small.