grepai-troubleshooting

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:

# 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:

# 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:

ollama serve

1. Check endpoint in config:

embedder:
  endpoint: http://localhost:11434  # Verify this

1. Test connection:

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:

# Download the model
ollama pull nomic-embed-text

# Verify
ollama list

---

Issue: Search returns no results

Symptom: Searches return empty or very few results.

Causes:

1. Index is empty
2. Files are being ignored
3. Query too specific

Solutions:

1. Check index status:

grepai status
# Should show files > 0 and chunks > 0

1. Verify files are being indexed:

# Check ignore patterns in config
cat .grepai/config.yaml | grep -A 20 "ignore:"

1. Try broader query:

grepai search "function"  # Very broad test