Easy Complete
macOS · 100% 本地 · 开源

为 macOS 终端而生的自动补全。

为数百种命令行工具提供 fish 风格的补全建议——git、npm、docker、cargo。原生、快速,而且完全在本机运行。

下载 DMG在 GitHub 查看
brew install --cask chen86860/tap/easy-complete
ec — zsh — 80×24live
~/web-app❯g
↑↓navigate⇥acceptescdismiss

在你惯用的终端里运行

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

补全一条命令所需的一切,多余的一概没有。

只做一件事并做好——没有聊天、没有 AI 调用、没有云端补全。

›_

行内补全

输入的同时给出 IDE 风格的建议——子命令、参数、选项和文件路径,按你真正想输入的内容排序。

⌘

数百种 CLI

开箱即用地支持 git、npm、docker、cargo、aws、kubectl 等大量常用工具的补全规格。

◳

原生浮层

紧贴光标的轻量原生窗口,不是靠转义序列在提示符里硬画出来的。

⚡

快且轻

用 Rust 编写,毫秒级给出建议,你的击键和补全之间没有延迟。

◆

100% 本地

无云端、无账号、无 AI 调用。你的命令永远不会离开这台机器。

◐

可换主题

与终端配色保持一致,内置 GitHub Dark 等多套主题。

⊞

到处都能用

多数终端开箱即用;Ghostty、Otty、Kitty、WezTerm、Zed 和 Alacritty 还能获得像素级光标跟踪。

$

IDE 内置终端

补全会跟着你进入 VS Code、Cursor、ChatGPT(Codex)以及 JetBrains 系 IDE 的终端。

⇥

一条命令装好

./install.sh 完成构建、安装并接好 Shell 集成——之后直接开始输入即可。

为什么选 Easy Complete

刻意为之的取舍。

01

只做补全,别的都不做

没有聊天、没有 AI 助手、没有云端补全。一件事,做好。

02

原生应用,不是插件

一个真正的 macOS 应用和真正的浮层窗口,而不是往提示符里塞一串转义字符。

03

默认保护隐私

补全完全在本机完成——命令内容不会离开你的 Mac。仅收集匿名使用计数,一条命令即可关闭。

04

开源

一个专注的本地补全引擎,为快速的终端自动补全而生。

支持的终端

你在哪儿敲命令,它就在哪儿。

✓Ghostty✓Otty新增✓Kitty✓WezTerm✓Alacritty✓Zed✓JetBrains IDEs✓ChatGPT (Codex)新增✓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. 查看完整支持列表.

工作原理

三个进程,通过套接字通信。

用 Rust 编写,原生而轻量。每个进程只负责一件事,彼此通过 Unix 域套接字上的 Protobuf 消息协作。

easy-complete
crate · fig_desktop

原生应用宿主——承载补全浮层与设置面板(运行在 wry WebView 里的 React 应用)、系统托盘和窗口管理。

ecterm
crate · figterm

位于 Shell 与终端模拟器之间的伪终端;拦截 Shell 编辑缓冲区来驱动补全。

ec
crate · q_cli

命令行入口——setup、integrations、diagnostic、settings 等子命令。

Shell 钩子 → 当前目录 · 命令文本 · 光标⇄输入法助手 → 光标位置(macOS)⇄Unix 套接字上的 Protobuf
常见问题

安装前先看这些。

Easy Complete 是什么?

Easy Complete 是一款 macOS 终端自动补全应用,为命令行工具提供 IDE 风格的行内建议。

Easy Complete 在本地运行吗?

是的。补全完全在本机完成——无账号、无云端请求、无 AI 调用,命令内容不会离开你的 Mac。

Easy Complete 会收集哪些数据?

只有匿名使用统计:应用启动、安装/更新事件,以及每日补全计数,关联到一个随机设备 ID。命令内容、补全文本和文件路径从不收集。随时用 `ec telemetry disable` 关闭——完整清单见隐私政策页面。

Easy Complete 支持哪些终端?

Easy Complete 支持 Ghostty、Otty、Kitty、WezTerm、Alacritty、Zed、iTerm2、Apple Terminal、VS Code、ChatGPT(Codex)以及 JetBrains 系 IDE 终端。其中 Otty 与 ChatGPT(Codex)在 v2.1.0 加入。

如何安装 Easy Complete?

用 Easy Complete 的 Homebrew Cask 安装,或从 GitHub Releases 下载最新的 macOS DMG 并按安装指南操作。

文档

从下载到第一次补全。

安装 Easy Complete、确认你的终端是否受支持、为 Ghostty 配置光标跟踪,或修复 Shell 集成——都不用翻源码仓库。

浏览文档
在 macOS 上安装Homebrew 或 DMG、辅助功能权限、重载 Shell,以及用 ec doctor 验证。故障排查(英文)排查建议不出现、Shell 钩子失效和终端集成损坏的问题。Ghostty 自动补全(英文)Ghostty 为什么需要输入法,以及建议偏移时如何重新注册。Otty 自动补全(英文)输入法光标跟踪,以及 Easy Complete 如何与 Otty 自己的 Shell 集成共存。iTerm2 自动补全(英文)走辅助功能路径——没有输入法需要注册。隐私政策与遥测(英文)匿名事件的完整清单,以及关闭它们的那一条命令。

别再背参数了。

让终端替你记住。

下载 DMG在 GitHub 查看
brew install --cask chen86860/tap/easy-complete

需要 macOS 12+ · Apple Silicon(ARM64) · MIT
一个专注的本地补全引擎,为快速的终端自动补全而生。

Easy Complete文档安装故障排查隐私政策