Easy Complete
macOS · 100% local · open source

Autocomplete for your macOS terminal.

Fish-shell-style suggestions for hundreds of CLIs — git, npm, docker, cargo. Native, fast, and entirely on-device.

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

  • Ghostty
  • Otty
  • Kitty
  • WezTerm
  • Alacritty
  • Zed
  • JetBrains IDEs
  • ChatGPT (Codex)
  • VS Code
  • iTerm2
  • Apple Terminal
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

IDE-style suggestions the instant you type — subcommands, flags, arguments and file paths, ranked for what you actually mean.

⌘

Hundreds of CLIs

Out-of-the-box 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 a clunky shell hack.

⚡

Fast & lightweight

Built in Rust. Milliseconds to suggest, with no lag between you and your keystrokes.

◆

100% local

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

◐

Themeable

Match your terminal's vibe — ships with themes like GitHub Dark and more.

⊞

Works everywhere

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

$

In-IDE terminals

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

⇥

One-command setup

./install.sh builds, installs and wires up shell integration — then just 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

A focused local completion engine built for fast terminal autocomplete.

Supported terminals

Works everywhere you type.

✓Ghostty✓OttyNew✓Kitty✓WezTerm✓Alacritty✓Zed✓JetBrains IDEs✓ChatGPT (Codex)New✓VS Code✓iTerm2✓Apple Terminal

New in v2.1.0: Otty joins the input-method terminals with pixel-accurate cursor tracking, and ChatGPT (Codex) sessions are located through the xterm.js caret. 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 · cursor⇄input-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, ChatGPT (Codex), and JetBrains IDE terminals. Otty and ChatGPT (Codex) were added in v2.1.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 12+ · Apple Silicon (ARM64) · MIT
A focused local completion engine built for fast terminal autocomplete.

Easy CompleteDocsInstallTroubleshootingPrivacy Policy