BlockWatch — Your Git history. In Minecraft.

How it works

Three steps to a living codebase

BlockWatch bridges your terminal, your editor, and Minecraft into a single spatial interface.

🔎

Connect your repo

Run blockwatch start in any git repository. BlockWatch scans your history and generates a world plan from your file structure.

🏛

Watch your codebase as a living city

Your packages become districts, files become buildings, and commits become visible changes in the Minecraft world — in real time.

🤖

Guide your AI agents

AI agents connect via the MCP bridge and can emit events, report activity, and navigate your codebase spatially inside the world.

Features

Everything you need

BlockWatch is designed for developers who want a richer view of their work.

⚡

Real-time world generation

Changes to your repo are reflected in Minecraft within seconds. Watch your codebase grow and evolve as you commit.

🔗

AI agent integration via MCP

A built-in MCP bridge exposes tools for emitting events, reporting activity, querying world state, and injecting context.

🕑

Git history visualisation

Every commit in your history is a moment in time you can walk through. See how your architecture evolved spatially.

🎥

Demo mode — no Minecraft needed

Run blockwatch demo to see the full pipeline in action with a sample repository. No Minecraft installation required.

📂

Works with any git repo

Point BlockWatch at any local git repository. It handles monorepos, large histories, and complex directory structures.

🛠

Doctor command

Run blockwatch doctor to diagnose Java, Minecraft, and network issues before they become problems.

Install

Get started in seconds

BlockWatch requires Minecraft Java Edition 1.21.4 and Java 21 (auto-installed on Windows).

 macOS

curl -fsSL https://blockwatch.dev/install.sh | bash

Or download the DMG from GitHub Releases. Requires macOS 12+.

🪟 Windows

winget install blockwatch

Or download the NSIS installer from GitHub Releases. Bundles Java 21. Requires Windows 10+.

🐧 Linux