by yoanbernabeu
Semantic Search & Call Graphs for AI Agents (100% Local)
# Add to your Claude Code skills
git clone https://github.com/yoanbernabeu/grepaiSearch code by meaning, not just text.
Documentation · Installation · Quick Start
grepai is a privacy-first CLI for semantic code search. It uses vector embeddings to understand code meaning, enabling natural language queries that find relevant code—even when naming conventions vary.
Drastically reduces AI agent input tokens by providing relevant context instead of raw search results.
handleUserSessionNo comments yet. Be the first to share your thoughts!
Homebrew (macOS):
brew install yoanbernabeu/tap/grepai
Linux/macOS:
curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh
Windows (PowerShell):
irm https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.ps1 | iex
Ollama (recommended):
ollama pull nomic-embed-text
grepai init # Initialize in your project
grepai watch # Start indexing daemon
grepai search "error handling" # Search semantically
grepai trace callers "Login" # Find who calls a function
grepai supports autocompletion for commands, flags, and dynamic values (workspace names, project names, providers, backends).
Zsh (add to ~/.zshrc):
eval "$(grepai completion zsh)"
Oh-My-Zsh plugin:
mkdir -p ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/grepai
grepai completion zsh > ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/grepai/_grepai
# Then add "grepai" to plugins=(...) in ~/.zshrc
Bash:
# Linux
grepai completion bash > /etc/bash_completion.d/grepai
# macOS (requires bash-completion@2)
grepai completion bash > $(brew --prefix)/etc/bash_completion.d/grepai
Fish:
grepai completion fish > ~/.config/fish/completions/grepai.fish
PowerShell:
grepai completion powershell | Out-String | Invoke-Expression
"I just hit my limit and it took 13% of my max5 plan just to read my codebase. I am very, very excited about your new tool." — u/911pleasehold on r/ClaudeAI (280K+ views)
"It works great! Takes 5 minutes to install. Crazy!" — @LesSaleGeek on X
"The results are incredible!" — Kenny Nguyen on LinkedIn
grep was built in 1973 for exact text matching. Modern codebases need semantic understanding.
| | grep / ripgrep | grepai |
|---|---|---|
| Search | Exact text / regex | Semantic understanding |
| Query | "func.*Login" | "user authentication flow" |
| Finds | Pattern matches | Conceptually related code |
Full docs, guides, and blog:
See CONTRIBUTING.md for guidelines.
MIT License - Yoan Bernabeu 2026