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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/initialcommit-comgit-sim.svg)](https://yunodb.com/tools/initialcommit-comgit-sim?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/initialcommit-comgit-sim?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/initialcommit-comgit-sim.svg" alt="Featured on YunoDB" height="20"></a>