Stop Clicking, Start Reading: Render Any Git Repo as a Single HTML Page
Ever find yourself lost in the maze of a new GitHub repository? You’re clicking through folders, jumping between files, and trying to hold the entire structure in your head just to understand how the code fits together. What if you could just see everything at once?
That’s the idea behind rendergit, a clever new tool from Andrej Karpathy. It takes any Git repository and flattens it into a single, self-contained HTML file. No more tab hopping. No more context switching. Just the code.
What It Does
rendergit is a simple Python command-line tool that clones a repository, processes all its files, and generates one clean, static HTML page. This page contains the entire codebase—with syntax highlighting, rendered markdown, and a navigable sidebar. It’s like taking a snapshot of the project and laying it all out on one very long, very smart page.
Why It’s Cool
This isn’t just another pretty formatter. rendergit was built with two distinct audiences in mind:
-
👤 For Humans: The “Human View” gives you a beautifully formatted page with syntax highlighting (powered by Pygments), a clickable file tree, and clean navigation. It’s perfect for code reviews, exploring new codebases, or just getting a bird’s-eye view of a project. And yes, you can finally use Ctrl+F to search across the entire codebase at once.
-
🤖 For LLMs: The “LLM View” switches the entire repo into CXML format—a plain-text, structured representation that’s ideal for pasting directly into Claude, ChatGPT, or other LLMs. This is a game-changer for developers using AI assistants for code analysis, refactoring suggestions, or documentation.
Other thoughtful touches include automatic filtering of binary files and overly large files, mobile-responsive design, and a minimal setup process.
How to Try It
Getting started is straightforward, especially if you’re already using uv, the modern Python package manager:
uv tool install git+https://github.com/karpathy/rendergit
rendergit https://github.com/karpathy/nanogpt
That’s it. The tool will clone the repo, build the HTML, and automatically open it in your browser.
If you prefer a more manual approach:
git clone https://github.com/karpathy/rendergit
cd rendergit
pip install -e .
rendergit https://github.com/karpathy/nanogpt
Final Thoughts
rendergit is one of those utilities that feels obvious in hindsight. It solves a real, everyday pain point for developers without overcomplicating things. It’s fast, it’s simple, and it’s incredibly useful whether you’re doing a deep dive into a new codebase or prepping context for an LLM.
As Karpathy himself says in the README: he “vibe coded this utility” and doesn’t “super intend to maintain or support it,” so enjoy it for what it is—a sharp, focused tool that does one thing very well.
Give it a spin on your next project. You might just find it’s exactly what you’ve been missing.
— Follow us for more cool projects: @githubprojects