How mouatezmo/vibediff works
VibeDiff is a single-file terminal application for tracking project checkpoints and versioned snapshots. A user opens or registers a project, saves snapshots, then compares versions or restores a saved state. The README also documents automatic comparison on update, visual line and intra-line diffs, live search, text reports, and ripgrep-backed scanning. The excerpts show the managers and some storage, scanning, and viewer behavior; some wiring for unsampled operations is therefore left out.
Main entry points: vibediff.py Project manager
Components 13
Project workflow
- Application entry
vibediff.py - Project manager
vibediff.py - Terminal UI
vibediff.py
Snapshot handling
- Snapshot manager
vibediff.py - Snapshot storage
vibediff.py
Comparison experience
- Diff engine
vibediff.py - Visual diff viewer
vibediff.py - Text report generator
vibediff.py
Runtime services
- Environment manager
vibediff.py - Project scanner
vibediff.py
Other components
- Terminal user
- ripgrep
- Project files
Connections 14
- Terminal user → Application entry: runs
- Application entry → Environment manager: detects environment
- Application entry → Project manager: starts workflow
- Project manager → Terminal UI: presents menus
- Project manager → Snapshot storage: lists and reconciles
- Project manager → Snapshot manager: manages snapshots
- Snapshot manager → Project scanner: scans source
- Project scanner → Project files: reads files
- Project scanner → ripgrep: scans with
- Snapshot manager → Snapshot storage: saves snapshots
- Snapshot manager → Diff engine: compares versions
- Diff engine → Snapshot storage: reads snapshots
- Project manager → Visual diff viewer: opens visual diff
- Project manager → Text report generator: produces comparison report