Semantiq vs grep/find
grep et find font de la correspondance textuelle exacte. Semantiq cherche par sens -- il trouve verifyToken quand tu cherches "authentification".
Tableau comparatif
| Criteria | grep / find | Semantiq MCP |
|---|---|---|
| Search | Exact text match | Semantic (understands context) |
| Speed | Varies by codebase | 15-70ms typical |
| Relevance | No ranking | Scored results (0.0-1.0) |
| References | Manual tracing | Auto definitions + usages |
| Dependencies | grep import only | Bidirectional dependency graph |
| Context | Line-level only | Symbols, types, signatures |
| Filtering | Regex patterns | file_type, symbol_kind filters |
Exemples concrets
Trouver du code d'authentification
Avec grep, tu cherches par texte exact. Avec Semantiq, tu cherches par intention -- et tu obtiens des résultats classés.
grep -r "auth"
# Retourne chaque fichier contenant "auth" (des centaines de résultats)
# Pas de classement, pas de contexte, bruit écrasant1semantiq_search "gestionnaire authentification"2# Retourne : handleLogin, verifyToken, checkAuth3# Avec scores de pertinence (0.83, 0.76, 0.71)4# Comprend l'intention, pas juste le texteTracer une fonction
grep montre des lignes contenant du texte. Semantiq montre les relations structurées entre définitions et usages.
1grep -r "MDXRenderer"2# Affiche les correspondances textuelles dans chaque fichier3# Pas de distinction entre définition et usage4# Travail manuel pour comprendre le flux1semantiq_find_refs MDXRenderer2# Affiche : 1 définition + 8 usages dans 3 fichiers3# Sortie structurée : définitions vs usages4# Analyse d'impact instantanéeComprendre les dépendances
grep donne des lignes d'import brutes. Semantiq donne un graphe de dépendances complet -- dans les deux directions.
1grep "import"2# Sortie texte brute des lignes d'import3# Nécessite un parsing manuel4# Pas de compréhension des relations1semantiq_deps hero.tsx2# 14 imports (ce dont ce fichier a besoin)3# 3 fichiers qui l'importent (ce qui en dépend)4# Graphe bidirectionnel, sortie structuréeWorkflow recommandé
Semantiq trouve du code par sens. Les outils natifs lisent et modifient. Combine les deux :
| Step | Tool | Purpose |
|---|---|---|
| 1 | Glob "**/*.tsx" | List matching files by pattern |
| 2 | semantiq_search "feature" | Find code by meaning |
| 3 | semantiq_explain Symbol | Understand what a symbol does |
| 4 | semantiq_deps file | Map dependency graph |
| 5 | Read file.tsx | Read the full source code |
| 6 | Grep "exact pattern" | Find exact text matches |
| 7 | semantiq_find_refs Symbol | Check impact before refactoring |
| 8 | Edit file.tsx | Apply code changes |
Voir aussi
- Guide d'utilisation -- Exemples pratiques pour chaque outil
- Référence CLI -- Documentation complète des commandes