City Grid · An AgentGrid experiment

Your repository,
as a living city.

Files become buildings. Worktrees become islands. See changes take shape as construction sites, with traffic moving between them.

Download City GridWatch the tour
City Grid renders a repository as islands for worktrees, with files represented by buildings and active changes shown as construction sites.
The AgentGrid repository, rendered in City Grid.

Legend

How to read your city

City Grid's vocabulary mirrors git's. Once you learn the metaphor you can read a repo's health at a glance.

  • File → Building

    Floors follow lines of code on a log curve, capped at 45 floors.

  • Worktree → Island

    One island per `git worktree`. The Production Island sits at the center.

  • Added lines

    ghost floors. Green translucent ghost floors stack on top of buildings as the diff grows.

  • Deleted lines

    wireframe floors. Red wireframe floors mark the lines a diff removed.

  • Big diff → Crane

    Past ~80 changed lines a file gets scaffolding and a slowly rotating tower crane.

  • Active agent → Crew

    Construction crews and trucks swarm the file an agent is currently editing.

  • Prod users → Traffic

    Pedestrians and cars scaled to the repo's simulated population.

  • Commits → Live Feed

    Recent commit subjects scroll in the LIVE FEED panel like a city ticker.

Tour

Eighteen seconds in the city.

Cameras drift over the archipelago — past traffic, cranes, and a `feat/city-grid-landing` construction site. Click to play.

Rush hour in node_modules. Every diff breaks ground.

Gallery

Postcards from the city.

Isometric overview: satellite worktree islands around the Production Island — one per `git worktree`.
Day overview. One island per worktree.
Construction close-up: tower cranes over a building under construction, translucent green ghost floors stacking up the added lines.
Construction close-up. Tower cranes, green ghost floors.
Night mode: lit windows scale with lines of code; headlights are simulated production traffic.
Night mode. Lit windows scale with LOC.
One worktree, one island: districts are directories, buildings are files.
One worktree, one island. Districts are directories.

Story

Built in an evening, by a crew.

City Grid landed across five build phases — one commit each — at Build with Cursor, a one-evening hackday at the a16z San Francisco office in June 2026. A crew of Claude Code workers wrote the commits, orchestrated on an AgentGrid canvas.

Live Feed · five build phases, one commit each
  1. scaffold56e4834electron-vite + three skeleton — git scanner v0, typed IPC bridge, module contracts, placeholder city, smoke/screenshot modes
  2. backend42c6ed1incremental 3s status-hash scanning, -z parsing, cache eviction, fixture + smoke assertions
  3. hud1cd6e2bdark-chrome overlay — overview card, worktree chips, live feed, toolbar toggles, minimap, details panel, tooltips, keyboard nav
  4. simf448e32instanced traffic + pedestrians + construction crews — lane-following cars, cargo trucks, activity bursts, night headlights
  5. enginee1fc2ebfull CityEngine — treemap districts, instanced buildings with shader windows, construction visuals, terrain, camera flights, picking, plaques, minimap
Meet the crew that built it → agentgrid.shSource on GitHub ↗City Grid is an AgentGrid experiment. The same canvas that shipped this page.

Download · v0.1.0

Take your repo for a drive.

Drop a folder at launch, or point City Grid at a specific repo with CITYGRID_REPO=/path/to/repo.

macOS

v0.1.0

Apple Silicon · arm64

Download dmg · 97 MBOr .zip · 96 MB

Signed but not notarized. If macOS blocks first launch: System Settings → Privacy & Security → scroll to City Grid → Open Anyway.

Windows

v0.1.0

Windows 10 / 11 · x64

Download zip · 112 MB

Portable build — extract the zip and run City Grid.exe. No installer yet.

Power-userCITYGRID_REPO=/path/to/repoSkips the file picker and opens the repo on launch.