Gilvt-WTJ/gilvt
Gilvt-WTJ/gilvt has 128 GitHub stars and 21 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-18 08:05 UTC. Last push 2026-11-02.
实测星标增长
- 24小时
- 0
- 7天
- 正在收集历史
- 15天
- 正在收集历史
- 1个月
- 正在收集历史
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Native macOS terminal for running, monitoring, and reviewing parallel Claude Code and Codex sessions.
开发工具README.zh-CN.md
原文English | 简体中文
gilvt
为并行运行和监控编程 Agent 设计的原生 macOS 终端。
Claude Code 和 Codex 照常在自己的 TUI 里运行;谁在等你一眼看到,每一轮的改动点一下就能 review。
官网与指南
·
下载
·
简介
·
安装
·
产品手册
·
参与贡献
·
开发文档
[!NOTE] gilvt 还处在 1.0 之前的早期阶段,只支持 macOS 11 及以上。界面语言默认跟随 Mac 的首选语言:中文时用简体中文,其他语言用英文。 可以在设置(
⌘,)→「语言」里选定,或在~/.config/gilvt/config.toml里写language = "en"/"zh-CN"。
简介
同时开着三四个 Claude Code、Codex 会话时,最难的是知道:哪个停下来在等你批准,哪个刚跑完测试失败了,哪个已经做完、 等你看结果。普通终端只给你一格格文字,你只能挨个标签去翻。
gilvt 首先是一个完整的日常终端:标签页、分屏、真彩色、Kitty 键盘协议、中文输入法、查找和大容量回滚,用 GPU 原生渲染 (gpui + alacritty_terminal)。在此之上,它读懂你的 编程 Agent 在做什么:
- 左栏:所有 Agent 会话集中在一个列表里,「需要你」的排在最上面,
⌘⇧J跳到下一个。 - 一眼看清状态:pane 描边和标签圆点按状态着色(需要你 · 出错 · 执行中 · 完成未看)。
- 检查器:按轮次把每条命令、每次文件修改、TODO 和失败列成时间线,点一行终端就滚回那里;每轮的文件改动和「本轮」diff。
- 系统通知和 Dock 角标:你在别的应用里时,有会话需要你就提醒。
- 会话管理:找回几天前的会话接着做(
⌘⇧R),在任意目录或新的 git worktree 里开出新 Agent(⌘⇧N),离线 Review 跑完的会话,归档和清理。 - 监控官(
⌘⇧O):所有窗口的会话和终端排成卡片墙,可选的 AI 总结和只读对话(默认关闭,用你本机的 CLI)。 - Quick Look 与编辑器:代码高亮与 diff、排版后的 Markdown 和 Mermaid、
⌘P模糊找文件,以及带实时预览的内置编辑器。 - SSH 远程(预览):
ssh到 Linux 或 Apple 芯片的 Mac 后,在那里运行的 Agent 和本地的一样出现在左栏;gilvt view/gilvt diff打开远端的文件。 - 725 套内置主题,也支持自己的主题;窗口外框跟着主题变。
一个窗口里的六个会话:等待审批、提问、执行中、出错、已完成,右侧是检查器时间线,底部是监控官命令条。
设计原则:
- Agent 始终是原生 TUI。 gilvt 不另做聊天界面,也不提供审批按钮。
- 只观察,不代答。 gilvt 只展示状态、移动焦点,从不向 Agent 输入任何按键。
- 不改你的配置。 shell 集成和 Agent hooks 都通过启动参数和临时文件注入。除非你主动运行
gilvt integrate install, 你的 rc 文件、~/.claude、~/.codex都不会被改动。 - 出问题只降级,不崩坏。 hooks 没生效或会话记录解析失败时,gilvt 退回精简模式或普通终端。
安装
下载 macOS 版 gilvt(macOS 11 及以上,Apple 芯片与 Intel 通用,已签名并公证)。打开磁盘映像,把 Gilvt 拖进「应用程序」再从那里打开,然后在 pane 里运行 claude 或 codex,左栏和检查器会自动识别这个会话。应用会自动保持最新,在你退出时安装更新。更多见 gilvt.com。
也可以用 Homebrew 安装:
brew install --cask gilvt-wtj/gilvt/gilvt
它同时把 gilvt 命令放进 PATH。之后的更新仍由应用自己完成。
从源码构建
需要:macOS、Xcode Command Line Tools 和 Rust(rustup 会自动选用 rust-toolchain.toml 里固定的版本)。不需要完整的 Xcode。
git clone https://github.com/Gilvt-WTJ/gilvt.git
cd gilvt
scripts/bundle.sh release # 构建并签名 target/release/Gilvt.app
open target/release/Gilvt.app
请在 /tmp 以外的目录构建(macOS 会忽略 /tmp 下的 app)。原生通知和 Dock 角标需要从 app 启动。想让重新构建后
macOS 的隐私授权仍然有效,按 HACKING.md 的「稳定签名」创建一张自签名的 gilvt-dev 证书。从源码构建的版本没有自动更新。
文档
- 产品手册(排版版:用浏览器打开
docs/user-guide.zh-CN.html) - 编程 Agent 指南 与 Claude Code / Codex 集成
- 开发 gilvt:构建、目录结构与实现细节
- 验收清单 与 GUI 验收测试
- 设计文档
隐私
gilvt 没有遥测,自己不发起任何网络请求。它读取你本机上 Claude Code 和 Codex 的会话文件来显示状态。可选的监控官总结和
对话会调用你自己的 claude 或 codex CLI,由它照常连接各自的服务商。详见 PRIVACY.zh-CN.md。
参与贡献
欢迎提交 bug 报告和聚焦的 pull request。请先阅读 CONTRIBUTING.zh-CN.md 和 AI 使用政策。安全问题请见 SECURITY.zh-CN.md。
声明
gilvt 是独立项目,与 Anthropic、OpenAI 没有关联,也未获得它们的认可或赞助。Claude 和 Claude Code 是 Anthropic 的商标; Codex 是 OpenAI 的商标。
许可
Apache License 2.0。见 LICENSE 与 NOTICE。第三方许可列在 THIRD_PARTY_LICENSES.md。