Your AI agent is flying blind Give it a semantic map of your codebase

grepai indexes the meaning of your code, not just text patterns.
Find relevant code with natural language. Trace function calls. Ship faster.

Install with one command View Source

100% Local & Private

Open Source (MIT)

Works with Cursor, Claude Code, Windsurf

grepai — semantic search

grep 1973 grepai 2026

grep for the AI era

50 years ago, grep revolutionized text search. Today, your codebase needs semantic understanding.

grep

$ grep -r "auth" .

./src/utils/string.ts:42: // authorize string

./src/components/Header.tsx:8: author="John"

./src/lib/oauth.ts:15: authToken = null

./src/config.ts:3: // authentication config

./src/api/user.ts:89: reauthorize()

... 841 more results

847 results. Where's the actual auth logic?

grepai

$ grepai search "user authentication flow"

src/auth/login.ts:23-45

handleUserLogin() - validates credentials

Score: 0.94

src/middleware/session.ts:12-28

verifySession() - checks JWT token

Score: 0.87

2 results. Exactly what you need.

Search by meaning, not keywords

Trace callers & callees

Real-time index updates

Stop guessing. Start finding.

See how it works

What you get

Everything you need to make your AI tools actually understand your code

Find code you couldn't grep

Search "authentication logic" and find validateUser. grepai understands meaning, not just text patterns.

Know impact before you change

See who calls a function and what it calls. Refactor with confidence, not guesswork.

Your code stays on your machine

Runs 100% locally with Ollama. No cloud, no API calls, no data leaving your laptop.

Your AI agent gets smarter

Native MCP server and JSON output. Cursor, Claude Code, Windsurf work better with semantic context.

Always in sync

File watcher updates the index as you code. No manual re-indexing. Just search.

Instant results

Single binary, no dependencies. Index 10k files in seconds. Search in milliseconds.

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

280K+ views

"It works great! Takes 5 minutes to install. Crazy!"

@LesSaleGeek

"The results are incredible!"

Kenny Nguyen

Plug into your AI workflow

MCP server, JSON output, or CLAUDE.md rules. Your choice.

Recommended

Claude Code

Anthropic CLI

One command setup. Claude searches your code semantically.

Cursor

AI-first editor

Native MCP integration. Add grepai as a tool in settings.

Codex CLI

OpenAI agent

JSON output for seamless AI integration.

Windsurf

Gemini CLI

MCP Server

JSON output

Call graph tracing for

TypeScript

JavaScript

Python

PHP

J Java

C C#

C++

Rust

Zig

Get started in 30 seconds

From zero to semantic search in four commands

Install grepai

curl -sSL https://raw.githubusercontent.com/yoanbernabeu/grepai/main/install.sh | sh

Initialize your project
```
cd your-project && grepai init
```
Start indexing
```
grepai watch
```

Search with natural language

grepai search "user authentication flow"
grepai trace callers "Login"

Read the full guide

100% local or cloud-powered

Run locally with Ollama or use cloud embeddings

Recommended Privacy-first, runs 100% offline

# .grepai/config.yaml
embedder:
  provider: ollama
  model: nomic-embed-text

Cloud Faster indexing, requires API key

# .grepai/config.yaml
embedder:
  provider: openai
  model: text-embedding-3-small

Dive deeper

Everything you need to master grepai

Installation Guide

Detailed setup instructions for all platforms

Call Graph Tracing

Find callers, callees, and build dependency graphs

Configuration

Customize chunking, backends, and search options

AI Agent Setup

Integrate with Cursor, Claude Code, Windsurf

MCP Integration

Use grepai as a native MCP tool

AI Agent Skills

27 skills for Claude Code, Cursor, and more

Ready to give your AI agent superpowers?

Join developers who use grepai to ship faster with smarter AI assistance.

Get Started Free Star on GitHub