Skip to content

realtime-updates.md

Latest commit

 

History

History
62 lines (43 loc) · 1.9 KB

realtime-updates.md

File metadata and controls

62 lines (43 loc) · 1.9 KB
Raw
description Keep your Code-Graph-RAG knowledge graph synchronised with code changes using the real-time file watcher.

Real-Time Graph Updates

For active development, keep your knowledge graph automatically synchronised with code changes using the real-time updater.

What It Does

  • Watches your repository for file changes (create, modify, delete)
  • Automatically updates the knowledge graph in real-time
  • Maintains consistency by recalculating all function call relationships
  • Filters out irrelevant files (.git, node_modules, etc.)

Usage

Run the real-time updater in a separate terminal:

python realtime_updater.py /path/to/your/repo

Or using the Makefile:

make watch REPO_PATH=/path/to/your/repo

With Custom Memgraph Settings

python realtime_updater.py /path/to/your/repo \
  --host localhost --port 7687 --batch-size 1000
make watch REPO_PATH=/path/to/your/repo HOST=localhost PORT=7687 BATCH_SIZE=1000

Multi-Terminal Workflow

# Terminal 1: Start the real-time updater
python realtime_updater.py ~/my-project

# Terminal 2: Run the AI assistant
cgr start --repo-path ~/my-project

CLI Arguments

Argument Required Default Description
repo_path Yes Path to repository to watch
--host No localhost Memgraph host
--port No 7687 Memgraph port
--batch-size No Number of buffered nodes/relationships before flushing to Memgraph

Performance Note

The updater batches rapid saves with a debounce window and recalculates all CALLS relationships on every processed change to ensure consistency. This prevents "island" problems where changes in one file aren't reflected in relationships from other files, but may impact performance on very large codebases with frequent changes. Optimisation of this behaviour is a work in progress.