← ClaudeAtlas

grepai-troubleshootinglisted

Troubleshooting guide for GrepAI. Use this skill to diagnose and fix common issues.
NNIIKKKKII/grepai-skills · ★ 2 · AI & Automation · score 75
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