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
- Cursor uses a pre-prompt rules mechanism; compression happens per-request, not per-tool-call. Gains are smaller than the JSON-hook assistants.
- Copilot has no public pre-tool hook; tetris integrates at the CLI layer only. Inline suggestions in the IDE are not intercepted.
- Detection is directory-based. If you delete an assistant’s config directory, tetris no longer considers it installed, even if the binary remains. Tell us if this bites you.
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.