Skip to content
Easy Complete
Download

Autocomplete for your macOS terminal

Subcommands, flags, and file paths for hundreds of CLIs like git, npm, docker, and cargo, in a native popup at your cursor. Completions are built on your Mac.

Download DMGView on GitHub
brew install --cask chen86860/tap/easy-complete
ec — zsh — 80×24live
~/web-app❯g
↑↓navigate⇥acceptescdismiss

Runs in the terminal you already use

  • Kitty
  • Zed
  • Otty
  • iTerm2
  • Ghostty
  • ChatGPT (Codex)
  • VS Code
  • Kiro
  • Apple Terminal
  • JetBrains IDEs
  • Alacritty
  • WezTerm
Features

Everything you need to complete a command. Nothing you don't

One job, done well — no chat, no AI calls, no cloud completions

Inline completions

Suggestions as you type, the way your editor does it — subcommands, flags, arguments and file paths, ranked for what you actually mean.

Hundreds of CLIs

Bundled specs for git, npm, docker, cargo, aws, kubectl and many more popular tools.

Native overlay

A lightweight native window that floats right at your cursor — not escape codes drawn into your prompt.

Native and light

Written in Rust and drawn in a native window, so suggestions keep up with your typing.

100% local

No cloud, no account, no AI calls. Your commands never leave your machine.

Themeable

Match your terminal's colors with GitHub Dark and the other built-in themes.

Works everywhere

Most terminals work out of the box; Ghostty, Otty, Kitty, WezTerm, Zed and Alacritty also get cursor tracking accurate to the pixel.

In-IDE terminals

Completions follow you into VS Code, Cursor, Kiro, ChatGPT (Codex), and JetBrains IDE terminals.

Set up in one command

Install with Homebrew or the DMG. Shell integration sets itself up on first launch, so you can start typing.

Why Easy Complete

Opinionated, on purpose

01

Just autocomplete — nothing else

No chat, no AI assistant, no cloud completions. One job, done well.

02

Native, not a plugin

A real macOS app with a true overlay window, not a string of escape codes painted into your prompt.

03

Privacy by default

Completions run entirely on-device — your commands never leave your Mac. Only anonymous usage counts are collected, and one command turns them off.

04

Open source

MIT licensed. Read the code, file an issue, or build it yourself from the GitHub repository.

Supported terminals

Works everywhere you type

GhosttyOttyKittyWezTermAlacrittyZedJetBrains IDEsChatGPT (Codex)KiroNewVS CodeiTerm2Apple Terminal

New in v2.4.0: Kiro's integrated terminal gets completions, with the popup following its xterm.js caret just like in VS Code. Everything else keeps working through the shell integration installed automatically on first launch. See the full support list.

How it works

Three processes, talking over sockets

Native and lightweight, built in Rust. Each process owns one job and they coordinate over Unix domain sockets with Protobuf messages.

easy-complete
crate · fig_desktop

Native app host — owns the autocomplete overlay and dashboard (React apps in wry WebViews), system tray and window management.

ecterm
crate · figterm

Pseudoterminal between your shell and emulator; intercepts the shell edit buffer to drive completions.

ec
crate · q_cli

CLI entry point — setup, integrations, diagnostic, settings and more.

shell hooks → CWD · command text · cursorinput-method helper → caret position (macOS)Protobuf over Unix sockets
FAQ

Answers before you install

What is Easy Complete?

Easy Complete is a macOS terminal autocomplete app that shows IDE-style inline suggestions for command-line tools.

Does Easy Complete run locally?

Yes. Autocomplete runs fully on-device — no account, no cloud calls, no AI requests, and your commands never leave your Mac.

What data does Easy Complete collect?

Only anonymous usage statistics: app opens, install/update events, and daily completion counts, tied to a random device ID. Command content, completion text, and file paths are never collected. Disable it any time with `ec telemetry disable` — see the Privacy Policy page for the full list.

Which terminals does Easy Complete support?

Easy Complete supports Ghostty, Otty, Kitty, WezTerm, Alacritty, Zed, iTerm2, Apple Terminal, VS Code (including Cursor, Windsurf, and Trae), Kiro, ChatGPT (Codex), and JetBrains IDE terminals. Kiro was added in v2.4.0.

How do I install Easy Complete?

Install it with the Easy Complete Homebrew Cask, or download the latest macOS DMG from GitHub Releases and follow the install guide.

Docs

Get from download to first completion

Install Easy Complete, check which terminals are supported, set up cursor tracking for Ghostty, or fix a shell integration — without digging through the repository.

Browse the docs
Install on macOSHomebrew or DMG, Accessibility permission, shell reload, and verification with ec doctor.TroubleshootingDiagnose missing suggestions, stale shell hooks, and broken terminal integrations.Ghostty autocompleteWhy Ghostty needs the input method, and how to re-register it when suggestions drift.Otty autocompleteInput-method tracking, plus how Easy Complete coexists with Otty's own shell-integration block.Kitty autocompleteWhy closing every Kitty window is not the same as quitting it, and what that means for setup.WezTerm autocompleteThe wezterm-gui process, and what multiplexer domains do to remote completions.Alacritty autocompleteSetup for a terminal with no tabs — including how completions behave inside tmux.Zed terminal autocompleteCompletions in the Zed terminal panel, separate from Zed's own editor predictions.iTerm2 autocompleteThe Accessibility path — no input method to register, and how it sits with iTerm2 Shell Integration.Privacy policy & telemetryThe full list of anonymous events, and the one command that turns them off.Looking for a Fig alternative?What a focused, local completion engine includes — and what it deliberately leaves out.

Stop memorizing flags

Let your terminal remember them for you

Download DMGView on GitHub
brew install --cask chen86860/tap/easy-complete

Requires macOS 15+ · Apple Silicon (ARM64) · MIT
A focused local completion engine built for fast terminal autocomplete.

Easy CompleteDocsInstallTroubleshootingPrivacy policyMore tools from EMMMM.DEV