From 0e9bd5074e3596eaf57dbfeebbd75092c57f8c79 Mon Sep 17 00:00:00 2001
From: VibeXP Bot <bot@vibexp.io>
Date: Tue, 3 Feb 2026 23:52:33 +0100
Subject: [PATCH] Add LSP comparison FAQ to README

Explains how Code Navigator differs from language servers:
- Pre-computed graph vs on-demand computation
- Optimized for AI token efficiency
- Portable single-file format

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index ff62aad..37e0917 100644
--- a/README.md
+++ b/README.md
@@ -607,6 +607,15 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions. Contributions
 
 </details>
 
+<details>
+<summary><b>How is this different from using a language server (LSP)?</b></summary>
+
+- **Pre-computed vs On-demand**: Index once, query instantly — no server running per request
+- **AI-optimized**: Minimal token output for relationships, not IDE features like completions/hover
+- **Portable**: Single `.bin` file — no server connection or session state needed
+
+</details>
+
 ## 🤝 Contributing
 
 We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for: