git-sim
The visual layer for Git in your own repos: simulate, record, replay, audit, and share entire Git workflows, wherever you or your agents run them.
What is git-sim?
The visual layer for Git in your own repos: simulate, record, replay, audit, and share entire Git workflows, wherever you or your agents run them.
Overview of git-sim
What it is
git-sim is a command-line tool that provides a visual layer for Git repositories. It can simulate, record, replay, audit, and share individual Git commands or entire Git workflows. It generates interactive, web-first graphs that show the impact of Git operations without actually executing them on the repository. It also includes a live mode that watches a repository and animates every Git operation in real time. The tool is designed to work on Windows, macOS, and Linux, and requires Python 3.10 to 3.14 and Git.
Key features
- Simulate any Git command before running it, generating an interactive graph that opens in the browser.
- Live mode: watches a repository and records every Git operation (human or agentic) as a visual, interactive session that can be replayed and shared.
- Integrates with VS Code (and Cursor, Windsurf, VSCodium) via an extension, and with Jupyter notebooks via a magic command.
- GitHub Action integration: automatically generates textual and visual descriptions of PR merges, including safety assessment and undo instructions.
- Pre-flight risk check: evaluates how risky a command is and what could be lost before execution.
- Can wire into AI agents (Claude Code, GitHub Copilot, Cursor, Codex, Gemini CLI, and any MCP agent) to catch and review risky Git commands in real time.
- Output can be shared as a link, embed, HTML page, PNG/SVG image, MP4 video, or social post.
Use cases
- Developers who want to preview the effect of a Git command (merge, rebase, reset, etc.) before actually running it.
- Teams that need to audit, record, and replay Git workflows for training, documentation, or debugging.
- Users of AI coding agents who want a safety layer that visualizes and reviews Git commands proposed by the agent.
- Educators or presenters who want to create animated visualizations of Git operations for teaching or sharing.
Getting started
console$ pip install git-simOr pipx install git-sim, or uv tool install git-sim.Then, in any local Git repository, prefix any Git command with git-sim instead of git:console$ git-sim merge dev$ git-sim reset --hard HEAD^$ git-sim rebase mainFor live mode:console$ git-sim live
License and pricing
The license is GPL-2.0. The tool is open source.
Based on the project's public README and repository metadata.