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

2. Check endpoint in config:

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