🔥 Now Published on NPM

Your Codebase, Visualized.
In Real-Time.

A lightweight, zero-configuration local tool that watches your project and builds interactive graphs of your functions call hierarchy, database schemas (ERD), and architectural layers.

$ npx @vmcreate/ai-watcher
Explore Features
AI-Watcher Dashboard - http://localhost:4321
AI-Watcher Dashboard Mockup

Designed for Developer Clarity

No configuration files, no setups, no cloud uploads. Simply run it and explore your codebase.

Functions Call-Graph

Explore live call hierarchies between functions and methods. Hover highlights show caller/callee links, and broken connections trigger warnings.

Database ERD Visualizer

Auto-extracts database models from Prisma schemas, SQL scripts, and object classes. Displays relationship links with yellow PK and purple FK indicators.

Architecture Tree View

Organizes code into logical layers (CLI, Application, Server, DB, etc.) in a D3 tree, displaying functions count, file-level dependencies, and recent changes.

Zero Config. Run Instantly.

AI-Watcher works out of the box. Point it at any repository, and it immediately scans and serves the interactive visualization dashboard locally.

1

Run locally or globally

Type npx @vmcreate/ai-watcher inside your workspace root.

2

Explore the dashboard

Dashboard opens on http://localhost:4321 instantly.

3

Watch updates live

Graphs update dynamically as you modify files in your editor.

bash

viktor@laptop:~/project$ npx @vmcreate/ai-watcher


╔══════════════════════════════════════════════════════╗

║ AI-WATCHER v3.0.2 — Modular Architecture Edition ║

║ Functions Graph · DB ERD · Architecture View ║

╚══════════════════════════════════════════════════════╝


[AI-WATCHER] Watching root: C:\PROGRAMIRANJE\chronos

[AI-WATCHER] Scanning for source files and DB schemas…

[SYNC OK] Graphs ready: 130 functions · 36 DB entities · 253 links

[AI-WATCHER] Visualization App: http://localhost:4321

[AI-WATCHER] Browser opened: http://localhost:4321

🤖 Built for AI Agents

Synergy with your AI Coding Assistant

AI-Watcher writes a structured graph index to a local .ai_context.json file, allowing coding agents like Gemini, Claude, or Cursor to easily read and understand your codebase structure.

1. Read Context First

Instruct your agent to read .ai_context.json before any action to ensure 100% accurate codebase maps.

2. Context Digest (10,000-Line Rule)

When changes exceed 10,000 lines of code, AI-Watcher triggers a console warning instructing the agent to pause and summarize changes to prevent context drift.

3. Architectural Memory Sync

Ensures structural changes and design decisions are immediately written and integrated into the agent's persistent memory.