git-sim
在您自己的儲存庫中為 Git 提供視覺化層:模擬、記錄、重播、稽核及分享完整的 Git 工作流程,無論您或您的代理人在何處執行。
git-sim 是什麼?
在您自己的儲存庫中為 Git 提供視覺化層:模擬、記錄、重播、稽核及分享完整的 Git 工作流程,無論您或您的代理人在何處執行。
git-sim 概覽
這是什麼
git-sim 是一個命令列工具,為 Git 儲存庫提供視覺化層。它可以模擬、記錄、重播、稽核及分享單一 Git 指令或整個 Git 工作流程。它會產生互動式、以網頁為優先的圖形,顯示 Git 操作的影響,但不會實際在儲存庫上執行這些操作。它還包含一個即時模式,可以監看儲存庫並即時動畫呈現每一個 Git 操作。此工具設計在 Windows、macOS 和 Linux 上執行,需要 Python 3.10 至 3.14 以及 Git。
主要功能
- 在執行前模擬任何 Git 指令,產生互動式圖形並在瀏覽器中開啟。
- 即時模式:監看儲存庫並記錄每一個 Git 操作(人類或代理程式),形成可重播和分享的視覺化互動工作階段。
- 透過擴充功能整合 VS Code(以及 Cursor、Windsurf、VSCodium),並透過魔術指令整合 Jupyter 筆記本。
- GitHub Action 整合:自動產生 PR 合併的文字與視覺化描述,包含安全性評估與復原說明。
- 預先風險檢查:在執行前評估指令的風險程度以及可能遺失的內容。
- 可連接 AI 代理程式(Claude Code、GitHub Copilot、Cursor、Codex、Gemini CLI 及任何 MCP 代理程式),即時攔截與審查有風險的 Git 指令。
- 輸出可分享為連結、嵌入內容、HTML 頁面、PNG/SVG 圖片、MP4 影片或社群貼文。
使用情境
- 開發者想在實際執行 Git 指令(合併、變基、重設等)之前預覽其效果。
- 團隊需要稽核、記錄及重播 Git 工作流程,用於訓練、文件或除錯。
- 使用 AI 程式碼代理程式的使用者,想要一個安全層來視覺化並審查代理程式提出的 Git 指令。
- 教育者或簡報者想要為教學或分享建立 Git 操作的動畫視覺化。
快速開始
console$ pip install git-sim或者 pipx install git-sim,或 uv tool install git-sim。然後,在任何本機 Git 儲存庫中,將任何 Git 指令的 git 改為 git-sim:console$ git-sim merge dev$ git-sim reset --hard HEAD^$ git-sim rebase main若要使用即時模式:console$ git-sim live
授權與價格
授權為 GPL-2.0。此工具為開放原始碼。
內容整理自該專案公開的 README 與儲存庫資訊。