GitHub radar

Birdview: Architecture Maps for AI Coding

Generates architecture maps of your codebase before every AI coding session, so the agent sees the full picture and avoids breaking unrelated modules.

01Qiuner/birdview 305JavaScript

Birdview is a developer tool that builds an architecture map of your codebase and saves it as a self-contained HTML file — no server required, opens directly in a browser. Each module is assigned a stable identifier and linked to actual source code, not a manually drawn diagram. Before giving an agent a coding task, you share this map with it; the agent then sees the entire project structure and understands which modules a change might affect. The tool works in two stages: first it produces an evidence-backed architecture snapshot, then you declare the planned scope of changes. Birdview does not automatically monitor agent activity — the agent declares what it plans to touch, and the map keeps that context visible. Supports light and dark themes, relationship filtering, and side-by-side architecture comparison. Requires Node.js 18+, MIT license.

Why a vibe-coder should care

Without architectural context, an AI agent sees only the file it's editing and often breaks adjacent modules. Birdview gives it a bird's-eye view before every change. Especially useful in larger projects where module dependencies aren't obvious from a single file.

How to install

Copy this and send it to your agent — Claude Code, Codex, any of them:

Install Birdview from https://github.com/Qiuner/birdview — follow the README, run it on the current project, and show me the HTML architecture map.

Runs on any laptop — only Node.js 18+ required.

Open on GitHub