GitGatto

截图使用演示数据展示界面，项目名称与计数不代表实际使用指标。

GitGatto 是 macOS 原生 Git 与 GitHub 客户端，支持 Apple Silicon 和 Intel。除了日常仓库操作，还提供未提交代码备份、外部 Agent 活动记录、目标交付、回归定位和开发环境安装。

为什么做 GitGatto

写 GitGatto，是因为写完代码以后的事情同样费时间：整理一堆混在一起的改动，查一个回归从哪次提交开始，等 CI、审 PR、发版本。临时切换任务还容易弄丢草稿和未提交文件。

用了 Agent 以后，又多了几个实际问题：它改了什么、为什么这样改、失败时留下了什么，以及它说“完成”之后结果到底能不能用。我们想把这些事做好，而不是只给 Git 命令套一层按钮。GitGatto 继续使用系统 Git 和本机 CLI，让改动、证据、恢复点和后续操作都能查到。

灾备与保护 · 状态栏监控 · 目标交付 · 变更编排 · 回归取证 · 项目工具 · 安装与配置

特色功能

未提交代码的灾备，与外部 Agent 保护

灾备中心为加入 GitGatto 的本地仓库保存 Git bundle 和未提交文件。定时与重大改动备份跳过无变化内容，也可以手动创建恢复点；每个仓库最多轮换保留三份。

应用内 Agent 写入前可创建恢复点。仓库守卫观察外部 Agent、终端和脚本产生的删除、未提交内容丢失、引用回退及仓库不可用，列出异常原因与路径。可检查恢复点文件、对比内容、导出所选文件，或恢复为新的仓库副本。更换备份目录会迁移已有备份。

断电与异常退出按最近完整恢复点处理：先将内容和清单同步到磁盘，再写入并同步完成标记，最后轮换旧备份。下次启动处理未完成的写入。保护范围是已保存到磁盘且进入备份的内容；最后一次成功备份之后的改动、编辑器未保存内容及被排除文件不保证可恢复。仓库守卫检测变化，不拦截其他应用的每一条命令。

不打开主窗口，也能看仓库情况

状态栏可独立选择所有仓库或某个仓库，查看未提交改动、上游同步、恢复点、Actions、目标状态和每日活动点阵。收起时也显示仓库范围、改动数量与提醒；展开面板可滚动，沿用主程序主题。活动统计记录提交和检测到的变化，不计工时。

设置中开启“退出后继续监控”后，独立后台助手在主程序退出后继续监控，并按已有保护设置运行定时备份、重大改动备份和仓库守卫。重新打开主程序时交回任务，避免两边重复扫描。后台运行默认关闭，需要时由 macOS 授权。

监控总开关、各通道、状态栏显示和刷新间隔都在设置中。隐藏状态栏不会关闭已开启的后台灾备；关闭监控总开关或仓库保护则会停止相应任务。

把交付过程保存成可继续的目标

目标可直接选择“提交并推送”“创建 PR”“发布版本”或“自定义”，也可从当前改动、Issue、PR 和失败检查创建。页面先显示当前任务与进度，详细步骤和历史记录按需展开。

根据所选流程，逐项核对暂存、提交、Push、PR、Review、Actions、构建产物、Release、DMG、Appcast 和本机版本。自定义目标由 Agent 生成候选条件，确认后才执行。中断后重新读取实际状态再继续，不把 Agent 的文字回复当成成功结果；合并、发布标签和安装仍有单独确认。

把混在一起的改动拆成提交

变更中心按文件或 Diff 分块分组，可以分别写提交说明，也可以让 Agent 整理分组。执行前检查是否遗漏、重复分配，以及仓库是否已经变化，再创建恢复点并按顺序提交。

每个提交会运行差异检查或指定的验证命令。中途失败会尝试回退原 HEAD 和暂存边界；恢复点仍可用于检查，不承诺任何错误下都能自动回退成功。

在独立工作树里定位回归

回归取证用 git bisect 缩小首个故障提交的范围，不切换正在工作的目录。自动模式运行验证命令；手动模式把候选标为正常、故障或跳过。提交、判定、退出码、耗时和输出随任务保存。

定位后可把证据交给 Agent 修复、复验并准备 PR。验证命令必须能判断你要找的问题，跳过太多提交时不一定能得到唯一结论。

代码缘由、故障胶囊与活动记录

• 代码缘由：从文件行追溯提交，在 GitHub CLI 可用时继续查看关联 PR、Issue、Review 和 Checks。
• 故障胶囊：把基准提交、补丁、允许收录的未跟踪文件、失败命令、输出和工具版本导出为 .gatto。导入时校验结构与摘要，再在独立工作树恢复；不会自动执行包里的命令。只过滤已知敏感路径和可识别内容，分享前仍需检查。
• 外部 Agent 活动记录：将文件和 Git 引用变化，与当时工作目录位于仓库中的已知 Agent 进程关联，显示证据强度。进程恰好在运行，不等于能证明每次改动都是它造成的。

Agent 不只起草提交说明

支持 Codex CLI、Claude Code、Gemini CLI、OpenCode、DeepSeek Harness（dsh）、Cursor Agent、GitHub Copilot CLI、Qwen Code 和自定义 CLI。内置 Git 处理指引覆盖暂存审阅、提交起草、冲突、分支整理、历史恢复、仓库健康和发布检查，也可携带 Git LFS、hooks、签名或同步失败的原始输出继续排查。

项目处理、翻译、搜索和安装有独立执行通道。README 重写先预览再应用；Issue 和 PR 回复根据讨论与差异起草，可编辑，确认后才发送。

也可直接配置 OpenAI 兼容 API 或 DeepSeek API，无需为 API 模式安装 CLI。项目与翻译分别选择接口和模型，支持模型列表、能力检测与流式回复；密钥存入系统钥匙串。API Agent 可读取项目、执行命令并在受控范围修改文件，翻译通道不提供项目写入工具。

切换任务时，保存的不只是分支

工作现场可保存暂存与未暂存改动、未跟踪文件、分支、草稿、所选文件及关联目标和链接。恢复时核对仓库状态；也可以在独立工作树中打开。被忽略文件不在保存范围，现场不是独立备份。

从顶部“项目工具”或 ⌘K 进入。

安装之后，把配置和验证一起做完

应用仓库从 GitHub Releases 查找版本和安装包，区分下载与安装。DMG、ZIP 使用本机安装流程，需要命令行的交给 Agent；下载管理显示阶段、输出和重试入口。

开发工具库包含 99 种工具与运行库，可检测本机版本、多选或批量升级。安装与升级有各自队列，最多三路任务并行；Homebrew 写入串行调度，避免同时修改依赖。

安装任务继续处理需要的 PATH、插件注册、初始化和配置迁移，再检查可执行文件与实际版本。下载成功、Agent 说完成，都不能代替本机验证。缺少权限或配置时保留待处理事项；账号登录、系统授权仍需本人完成。“已安装”应用列表记录 GitGatto 的安装结果，不是整机应用清单。

Git 与 GitHub 的日常操作

• 工作区与历史：暂存、提交、Diff、提交图、Blame、文件历史和历史媒体预览；组合搜索 SHA、作者、路径、文本、日期和引用。
• 分支与恢复：分支、标签、远程、贮藏、工作树、引用比较、Reflog 恢复分支；整理提交支持重排、合并、拆分、修订、拣选、撤销和重置。历史重写会检查已发布提交，破坏性操作需要确认。
• 冲突与诊断：编辑合并、变基或贮藏冲突，继续、跳过或中止 Git 操作；检查 Git LFS、hooks 和工具环境。
• 多仓库同步：批量获取、拉取和推送，分别显示领先、落后、分叉、冲突和失败，可重试失败项。
• GitHub 项目：账号仓库、仓库与开发者搜索、自然语言检索、Star、Fork、克隆；应用内浏览代码、README、Release 和附件。
• 收件箱、Issue 与 PR：筛选待审阅、提及、检查失败等事项；创建和处理 Issue；PR 文件审阅、已查看标记、行评论、回复与 Review。
• Actions：查看运行和日志、重新运行或取消、下载构建产物。远端写入由明确操作触发，不因刷新页面自动执行。

阅读与翻译

Markdown、相对路径图片、源码、SVG 和媒体文件可直接预览。文档自动识别语言，使用独立翻译配置；译文按原文、路径和目标语言缓存，原文变化后不复用旧译文。已是目标语言或文本不足时可保持原文。翻译不是自动提交 README。

主题与界面

轻雾、轻毛玻璃、控制台、翠影、银页、曜幕共六种主题，区别包括布局、面板、侧栏和控件，不只是强调色。曜幕支持分开调整深浅色的背景、面板、文字、按钮与状态颜色，并提供珊瑚、海盐、松雾、暮紫预设。

侧栏分区可折叠、滚动，工作区域可调节尺寸。界面有 11 种语言，切换无需重启；使用方法见应用内“帮助 → 使用指南”。

安装与开始使用

从 Releases 下载 DMG，拖入“应用程序”。最低 macOS 14，发行包支持 Apple Silicon 与 Intel。正式版本和变更以 更新日志 及 Release 为准，README 介绍当前仓库能力。

打开本地仓库，或手动扫描后选择添加；不会整盘自动导入。GitHub 登录与 Agent 配置在设置中完成。应用更新从 GitHub Releases 和 Appcast 获取。

数据与权限

仓库列表、设置、目标、回归记录、对话、译文、下载记录和恢复点保存在本机；备份位置可更换。Git、SSH、GitHub CLI 和 Agent CLI 复用各自的凭据来源。

“本地保存”不等于“全部离线”：GitHub 功能会访问 GitHub，Agent 与翻译会将所需上下文交给配置的 CLI 或 API，后续数据处理取决于该工具及模型服务。执行前检查待发送内容；不要在命令、草稿或故障胶囊里放入凭据。系统目录变更仍受 macOS 授权约束。

路线图、架构与项目记录

路线图与后续计划 · 系统架构 · 版本记录

路线图按源码与版本记录更新，虚线为后续计划。Star 图更新于 2026-09-12 UTC，按当前 Stargazers 的加星日期累计，不包含已取消的 Star；点击查看在线记录。

从源码运行

需要 macOS 14+、Swift 6.1+；Xcode 工程配置见 project.yml。

git clone https://github.com/Lincb522/GitGatto.git
cd GitGatto
swift package resolve
swift test --no-parallel
swift run GitGatto

也可以打开 GitGatto.xcodeproj 使用 GitGatto scheme。修改工程结构后，用 XcodeGen 执行 ./scripts/generate-xcodeproj.sh 重新生成，不手改工程文件。应用使用 SwiftUI、AppKit、WebKit、AVKit、Alamofire 和 Sparkle；版本由 Package.resolved 锁定。

贡献与许可

贡献约定见 CONTRIBUTING.md，安全问题见 SECURITY.md。感谢 GitHub CLI、Sparkle、Alamofire、Reicon 及图标、动画资源作者；完整来源与许可见 THIRD_PARTY_NOTICES.md。

GitGatto 由 ZIJIU522 开发，基于 MIT License 开源。