# grepai search

> CLI reference for grepai search

## grepai search

Search codebase with natural language

### Synopsis

Search your codebase using natural language queries.

The search will:
- Vectorize your query using the configured embedding provider
- Calculate cosine similarity against indexed code chunks
- Return the most relevant results with file path, line numbers, and score

```
grepai search <query> [flags]
```

### Options

```
  -c, --compact               Output minimal format without content (requires --json or --toon)
  -h, --help                  help for search
  -j, --json                  Output results in JSON format (for AI agents)
  -n, --limit int             Maximum number of results to return (default 10)
      --path string           Path prefix to filter search results
      --project stringArray   Project name(s) to search (requires --workspace, can be repeated)
  -t, --toon                  Output results in TOON format (token-efficient for AI agents)
      --workspace string      Workspace name for cross-project search
```

### SEE ALSO

* [grepai](/grepai/commands/grepai/)	 - Semantic code search CLI

###### Auto generated by spf13/cobra on 30-Oct-2026