Development
Plugin
grepai
Semantic Search & Call Graphs for AI Agents (100% Local)
Plugin Signal68/100Solid
maintained75
capable37
documented100
adopted69
Install
$ npx -y skills add yoanbernabeu/grepai --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Stats
1,811
Stars
150
Forks
Maintained
Maintenance
C
Language
MIT
License
1mo ago
Last commit
7mo ago
Created
Repo: yoanbernabeu/grepai
What's inside
Skills
2/grepaiReplaces ALL built-in search tools. You MUST invoke this skill BEFORE using WebSearch, Grep, or Glob. NEVER use the built-in Grep tool - use `grepai` instead./releaseCreate a new release for grepai. Checks CI, determines version type, updates CHANGELOG and documentation, credits contributors, and creates GitHub release.
Commands
2Badges
6
README
1grepai
grep for the AI era
Search 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.
Features
- Search by intent — Ask "authentication logic" and find
handleUserSession - Trace call graphs — Know who calls a function before you change it
- 100% local — Your code never leaves your machine
- Always up-to-date — File watcher keeps the index fresh automatically
- AI agent ready — Works with Claude Code, Cursor, Windsurf out of the box
- MCP server — Your AI agent can call grepai directly as a tool
Installation
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
Requires an embedding provider — Ollama (default), LM Studio, or OpenAI.
Ollama (recommended):
ollama pull nomic-embed-text
Quick Start
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
Shell Completion
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
What developers say
"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
Why grepai?
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 |
Documentation
Full docs, guides, and blog:
- Documentation — Configuration, AI agents, MCP setup
- Blog — Benchmarks, tutorials, release notes
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License - Yoan Bernabeu 2026
File tree
300yoanbernabeu/grepaiView on GitHub
.claude/
agents/
deep-explore.md
commands/
review-pr.md
work-issue.md
skills/
grepai/
SKILL.md
release/
SKILL.md
.editorconfig
.github/
dependabot.yml
ISSUE_TEMPLATE/
bug_report.yml
config.yml
feature_request.yml
PULL_REQUEST_TEMPLATE.md
workflows/
ci.yml
docs.yml
release.yml
.gitignore
.golangci.yml
.goreleaser.yml
CHANGELOG.md
CLAUDE.md
cli/
agent_setup_test.go
agent_setup.go
completion_test.go
completion.go
init_test.go
init_ui_prompt_test.go
init.go
mcp_serve_test.go
mcp_serve.go
refs_test.go
refs.go
root.go
search_path_filter_test.go
search_test.go
search.go
stats.go
status_files_test.go
status_watch_hint_test.go
status.go
trace_test.go
trace_ui_error_test.go
trace_ui_flag_test.go
trace.go
tui_components_ledger.go
tui_components_progress.go
tui_components.go
tui_init_test.go
tui_init.go
tui_layout_test.go
tui_runtime_test.go
tui_runtime.go
tui_stats_test.go
tui_stats.go
tui_theme.go
tui_trace_empty_state_test.go
tui_trace.go
tui_watch_test.go
tui_watch.go
tui_workspace_test.go
tui_workspace.go
update.go
watch_dynamic_worktree_test.go
watch_framework_test.go
watch_initialscan_test.go
watch_log_dir_hint.go
watch_multiworktree_rpg_test.go
watch_prefix_store_test.go
watch_ready_test.go
watch_test.go
watch_workspace_test.go
watch_worktree_discovery_test.go
watch.go
workspace_create_test.go
workspace_path_prefix_test.go
workspace_status_ui_test.go
workspace.go
cmd/
gendocs/
main.go
grepai/
main.go
CODE_OF_CONDUCT.md
compose.yaml
config/
config_test.go
config_worktree_test.go
config.go
workspace_test.go
workspace.go
CONTRIBUTING.md
daemon/
daemon_test.go
daemon_unix_test.go
daemon_unix.go
daemon_windows_test.go
daemon_windows.go
daemon.go
example_test.go
workspace_test.go
workspace.go
docs/
astro.config.mjs
package-lock.json
package.json
public/
favicon.svg
rpg_technical_report.md
src/
components/
content/
Badge.astro
Callout.astro
Card.astro
CardGrid.astro
CodeBlock.astro
LinkCard.astro
Steps.astro
TabItem.astro
Tabs.astro
docs/
Breadcrumbs.astro
Pagination.astro
Sidebar.astro
TableOfContents.astro
global/
CopyCodeButton.astro
Footer.astro
Header.astro
Logo.astro
Search.astro
homepage/
HeroAnimated.astro
ProblemSection.astro
TerminalDemo.astro
WorksWithSection.astro
content/
content.config.ts
blog/
benchmark-grepai-vs-grep-claude-code.md
introducing-grepai-skills.md
multi-project-workspace.md
welcome.md
docs/
backends/
embedders.md
stores.md
commands/
.gitkeep
grepai_init.md
community-tools.md
configuration.md
contributing.md
getting-started.md
git-worktrees.md
hybrid-search.md
installation.md
mcp.md
quickstart.md
search-boost.md
search-guide.md
skills.md
subagent.md
trace.md
watch-guide.md
workspace.md
layouts/
BaseLayout.astro
BlogLayout.astro
DocsLayout.astro
SplashLayout.astro
pages/
[...slug].astro
404.astro
blog/
[slug].astro
index.astro
index.astro
styles/
animations.css
global.css
utils/
navigation.ts
tailwind.config.mjs
tsconfig.json
embedder/
batch_test.go
batch.go
embedder_test.go
embedder.go
errors_test.go
errors.go
factory_test.go
factory.go
lmstudio.go
ollama.go
openai_batch_test.go
openai_helpers_test.go
openai_rate_limit_test.go
openai.go
openrouter_test.go
openrouter.go
rate_limiter_test.go
rate_limiter.go
retry_test.go
retry.go
synthetic_test.go
synthetic.go
flake.lock
flake.nix
framework/
astro_processor.go
errors.go
map.go
registry_test.go
registry.go
scripts/
vue_processor.mjs
solid_processor.go
svelte_processor.go
types.go
util.go
vue_matrix_test.go
vue_processor_test.go
vue_processor.go
warnings.go
fsharp/
binding.go
parser.c
scanner.c
scanner.h
tree_sitter/
alloc.h
array.h
parser.h
git/
git_test.go
git.go
go.mod
go.sum
indexer/
chunker_test.go
chunker.go
gitignore_test.go
gitignore.go
indexer_branchswitch_test.go
indexer_test.go
indexer.go
scanner_test.go
scanner.go
install.ps1
install.sh
internal/
fileutil/
flock_unix.go
flock_windows.go
helpers.go
LICENSE
Makefile
mcp/
server_discovery_test.go
server_path_filter_test.go
server_test.go
server.go
README.md
rpg/
evolver_helpers.go
evolver_test.go
evolver.go
extractor_llm_test.go
extractor_llm.go
extractor_local.go
extractor_test.go
features.go
hierarchy_test.go
hierarchy.go
indexer_incremental_test.go
indexer_test.go
indexer.go
model_edgefilter_test.go
model_test.go
model.go
query_test.go
query.go
store_gob_test.go
store_gob.go
store.go
summary.go
version.go
scripts/
test-vue-framework-matrix.sh
test-vue-framework-processing.sh
search/
boost_test.go
boost.go
dedup_test.go
dedup.go
hybrid_test.go
hybrid.go
path_normalizer_test.go
path_normalizer.go
search.go
SECURITY.md
stats/
doc.go
flock_unix_test.go
flock_unix.go
flock_windows.go
reader.go
recorder.go
stats_test.go
stats.go
store/
gob_test.go
gob.go
postgres_sql_test.go
postgres_test.go
postgres.go
qdrant_test.go
qdrant.go
search_path_filter_test.go
store.go
trace/
extractor_test.go
extractor_ts_csharp_test.go
extractor_ts_docstring_test.go
extractor_ts_fsharp_test.go
extractor_ts.go
extractor.go
patterns.go
store_graph_test.go
store_test.go
store.go
trace.go
workspace_test.go
workspace.go
updater/
cross_device_unix.go
cross_device_windows.go
updater_test.go
updater.go
watcher/
watcher.goFAQ
grepai is a Claude Code plugin with 2 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes grepai, release. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is grepai?
- Semantic Search & Call Graphs for AI Agents (100% Local)
- How do I install grepai?
- Run these in Claude Code: npx -y skills add yoanbernabeu/grepai --agent claude-code. Then prompt normally.
- Does grepai auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is grepai free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.