grepai-troubleshooting

Diagnose and resolve common GrepAI indexing, search, and configuration issues.

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-troubleshooting-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grepai-troubleshooting
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/grepai-troubleshooting
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-troubleshooting-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When GrepAI semantic search stops working—indexes go missing, embedding providers fail to connect, or searches return poor results—developers waste time guessing at causes. This Skill provides structured diagnostic procedures and proven fixes for the most common GrepAI failure modes. ## Core Features & Use Cases - Quick Diagnostics: Run version, status, config, and Ollama connectivity checks to pinpoint the failing component. - Issue-by-Issue Fixes: Step-by-step solutions for index-not-found errors, embedding provider connection failures, missing models, empty or irrelevant search results, outdated indexes, slow indexing, trace failures, MCP integration problems, memory pressure, and OpenAI API key errors. - Full Reset Procedure: A last-resort workflow that removes .grepai data and rebuilds the index from scratch. - Use Case: Your AI assistant reports "Cannot connect to Ollama at http://localhost:11434". Use this Skill to verify Ollama is running, check the configured endpoint, and pull the missing embedding model. ## Quick Start Ask the assistant to diagnose why GrepAI search is returning no results in the current project.

Frequently Asked Questions about grepai-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix GrepAI "Index not found" error?▼

The index-not-found error means no index exists for the project. Run grepai init to create the configuration, then run grepai watch to build the index before searching.

Why can't GrepAI connect to Ollama?▼

Connection failures usually mean Ollama is not running, the endpoint in .grepai/config.yaml is wrong, or a firewall blocks the port. Start Ollama with ollama serve and verify connectivity with curl http://localhost:11434/api/tags.

How do I fix GrepAI search returning no results?▼

Empty results usually come from an empty index, overly broad ignore patterns, or a too-specific query. Check grepai status for file and chunk counts, review ignore rules in .grepai/config.yaml, and retry with a broader query.

Does GrepAI work with OpenAI instead of Ollama?▼

Yes, GrepAI supports OpenAI as an embedding provider by setting provider to openai with a model like text-embedding-3-small in the config. You must export a valid OPENAI_API_KEY environment variable or you will get 401 Unauthorized errors.

Why is GrepAI indexing so slow on large codebases?▼

Slow indexing comes from large codebases, slow embedding providers, or missing ignore patterns. Add directories like node_modules and dist to the ignore list, use a smaller model such as nomic-embed-text, or switch to OpenAI with higher parallelism.

How do I reset GrepAI when nothing else works?▼

Delete the entire .grepai directory with rm -rf .grepai, then run grepai init followed by grepai watch to rebuild configuration and index from scratch.