Easy Complete

iTerm2 autocomplete

iTerm2 completions, without an input method.

iTerm2 exposes its caret through the macOS Accessibility API, so Easy Complete reads the cursor position directly. There is no input method to register for this one.

Cursor trackingAccessibility — macOS Accessibility API
Bundle IDcom.googlecode.iterm2
Process namesiTerm2
RequirementsmacOS 12 or later, Apple Silicon (ARM64)

Set it up

Install Easy Complete, approve it under System Settings → Privacy & Security → Accessibility, then reload your shell. iTerm2 needs no further integration.

If the permission prompt never appeared, trigger it again from the CLI.

ec debug prompt-accessibility
exec $SHELL

It coexists with iTerm2 Shell Integration

iTerm2's own Shell Integration writes its own prompt markers and status bar hooks. Easy Complete's hooks are separate and additive — you can keep both installed.

If you have customised PROMPT_COMMAND or precmd heavily, run ec doctor to confirm both hooks still load.

ec doctor

tmux integration mode

In tmux -CC mode iTerm2 draws native tabs for tmux windows. The shell still runs under tmux, so completions follow the shell as usual — but the caret is reported by whichever native tab has focus.

If suggestions appear in the wrong tab, detach and reattach the tmux session.

Keyboard controls

  • ↑ / ↓ moves through suggestions.
  • Tab / → accepts the highlighted suggestion.
  • Esc dismisses the popup.

Keep going

All supported terminals →The full matrix of cursor-tracking paths, terminal by terminal.Troubleshooting →Diagnose permissions, shell hooks, and integrations.