Semantiq vs grep/find
grep and find match exact text patterns. Semantiq matches by meaning -- it finds verifyToken when you search for "authentication".
Comparison Table
| 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 |
Search
grepExact text match
SemantiqSemantic (understands context)
Speed
grepVaries by codebase
Semantiq15-70ms typical
Relevance
grepNo ranking
SemantiqScored results (0.0-1.0)
References
grepManual tracing
SemantiqAuto definitions + usages
Dependencies
grepgrep import only
SemantiqBidirectional dependency graph
Context
grepLine-level only
SemantiqSymbols, types, signatures
Filtering
grepRegex patterns
Semantiqfile_type, symbol_kind filters
Real-World Examples
Finding authentication code
With grep, you search by exact text. With Semantiq, you search by intent -- and get ranked results.
Terminal
grep -r "auth"
# Returns every file containing "auth" (hundreds of results)
# No ranking, no context, overwhelming noiseTerminal
1semantiq_search "authentication handler"2# Returns: handleLogin, verifyToken, checkAuth3# With relevance scores (0.83, 0.76, 0.71)4# Understands intent, not just textTracing a function
grep shows you lines containing text. Semantiq shows you structured relationships between definitions and usages.
Terminal
1grep -r "MDXRenderer"2# Shows text matches in every file3# No distinction between definition and usage4# Manual work to understand the flowTerminal
1semantiq_find_refs MDXRenderer2# Shows: 1 definition + 8 usages across 3 files3# Structured output: definitions vs usages4# Instant impact analysisUnderstanding dependencies
grep gives you raw import lines. Semantiq gives you a complete dependency graph -- both directions.
Terminal
1grep "import"2# Raw text output of import lines3# Requires manual parsing4# No understanding of relationshipsTerminal
1semantiq_deps hero.tsx2# 14 imports (what this file needs)3# 3 files that import it (what depends on it)4# Bidirectional graph, structured outputRecommended workflow
Semantiq finds code by meaning. Native tools read and modify it. Use both together for the best results:
| 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 |
1
Glob "**/*.tsx"List matching files by pattern
2
semantiq_search "feature"Find code by meaning
3
semantiq_explain SymbolUnderstand what a symbol does
4
semantiq_deps fileMap dependency graph
5
Read file.tsxRead the full source code
6
Grep "exact pattern"Find exact text matches
7
semantiq_find_refs SymbolCheck impact before refactoring
8
Edit file.tsxApply code changes
See Also
- Usage Guide -- Practical examples for each tool
- CLI Reference -- Complete command documentation