grepai-troubleshootinglisted
Install: claude install-skill NNIIKKKKII/grepai-skills
# GrepAI Troubleshooting
This skill provides solutions for common GrepAI issues and diagnostic procedures.
## When to Use This Skill
- GrepAI not working as expected
- Search returning poor results
- Index not updating
- Connection or configuration errors
## Quick Diagnostics
Run these commands to understand your setup:
```bash
# Check GrepAI version
grepai version
# Check project status
grepai status
# Check Ollama (if using)
curl http://localhost:11434/api/tags
# Check config
cat .grepai/config.yaml
```
## Common Issues
---
### Issue: "Index not found"
**Symptom:**
```
Error: Index not found. Run 'grepai watch' first.
```
**Cause:** No index has been created for this project.
**Solution:**
```bash
# Initialize if needed
grepai init
# Create the index
grepai watch
```
---
### Issue: "Cannot connect to embedding provider"
**Symptom:**
```
Error: Cannot connect to Ollama at http://localhost:11434
```
**Causes:**
1. Ollama not running
2. Wrong endpoint configured
3. Firewall blocking connection
**Solutions:**
1. Start Ollama:
```bash
ollama serve
```
2. Check endpoint in config:
```yaml
embedder:
endpoint: http://localhost:11434 # Verify this
```
3. Test connection:
```bash
curl http://localhost:11434/api/tags
```
---
### Issue: "Model not found"
**Symptom:**
```
Error: Model 'nomic-embed-text' not found
```
**Cause:** The embedding model hasn't been downloaded.
**Solution:**
```bash
# Download the model
ollama pull nomic-embed-text
# Verify
oll