1. Install with Homebrew
Install the signed and notarized app with one Homebrew command. The Easy Complete tap is added automatically:
brew install --cask chen86860/tap/easy-complete
Prefer to install manually? Download the latest signed DMG, open it, and drag Easy Complete.app into your Applications folder.
Download the ARM64 DMG instead
2. Launch Easy Complete
- Open Easy Complete from
/Applications. - The first launch installs the bundled CLI, shell integration, and terminal input method.
- Open Settings from the menu bar icon if you want Easy Complete to launch at login.
3. Grant Accessibility permission
macOS Accessibility permission lets Easy Complete position the native suggestion window beside your terminal cursor. Approve Easy Complete at:
System Settings → Privacy & Security → Accessibility
If the prompt did not appear, trigger it again from Terminal:
ec debug prompt-accessibility
4. Reload your shell
Start a fresh shell session so zsh, bash, or fish can load the integration.
exec $SHELL
5. Verify the installation
Run the built-in doctor, then type a familiar command such as git or npm. Suggestions should appear beside the cursor.
ec doctor
Build from source
Developers can build the same app locally from the open-source repository:
git clone https://github.com/chen86860/easy-complete.git cd easy-complete ./install.sh