Easy Complete

Troubleshooting

When suggestions disappear, start with the integration.

Most autocomplete problems come from macOS permission state, a shell that has not reloaded, or a terminal input method that needs to be registered again.

ec doctor

No suggestions appear

  • Confirm Easy Complete is running from the menu bar.
  • Enable it under System Settings → Privacy & Security → Accessibility.
  • Reload your shell with exec $SHELL.
  • Open a new terminal window and test with git or npm.
ec debug prompt-accessibility
exec $SHELL

The popup is missing or misaligned in Ghostty or Otty

Ghostty, Otty, Kitty, WezTerm, Zed, and Alacritty use the bundled input method for pixel-accurate cursor tracking. Re-register it, then fully restart the terminal.

ec integrations install input-method

The CLI command is not found

The installer places the Easy Complete CLI in ~/.local/bin. Confirm that directory is in your PATH, then start a new shell session.

echo $PATH
command -v ec

Collect diagnostic information

If the built-in checks do not resolve the problem, print the integration and environment state before opening a GitHub issue. Review the output and remove anything you do not want to share.

ec diagnostic

Keep going

Recheck installation →Verify every first-run step.Ghostty guide →Understand the input-method integration.