yoanbernabeu/grepai-skills
Overview
This skill helps you configure and manage multi-project workspaces in GrepAI so related repositories can share a unified search index and configuration. It streamlines indexing, cross-project semantic search, and workspace-level status and configuration. Use it to organize monorepos, microservices, or any set of related projects you want to query together.
How this skill works
You create a named workspace and add project paths to it; GrepAI stores workspace config under ~/.grepai/workspaces/<name> and builds a combined index and symbols store. Run grepai watch --workspace <name> to index all projects (foreground or background), then search across the entire workspace or limit queries to a single project with --project. The workspace also exposes status, listing, removal, and deletion commands so you can manage the index and daemon per workspace.
When to use it
- Managing a monorepo with many packages that should be searchable together
- Exploring dependencies across microservices or separate services
- Keeping frontend, backend, and shared libraries in one searchable context
- Maintaining a combined semantic index for related projects
- Running an MCP server or daemon scoped to a logical project group
Best practices
- Name workspaces descriptively (e.g., ecommerce-stack) for clarity
- Group only related projects you commonly search together to reduce noise
- Run a single watcher per workspace (grepai watch --workspace) to keep indexes up to date
- Re-index after major refactors, adds, or removals to keep search accurate
- Use the --project filter when you want focused results from one codebase
Example use cases
- Create a monorepo workspace and add web, mobile, and shared packages for unified search
- Bundle related microservices into a services workspace to trace cross-service calls
- Combine frontend, backend, and shared-types into a fullstack workspace for end-to-end queries
- Run grepai watch --workspace my-workspace --background to keep a long-running indexer
- Use grepai search --workspace services "REST API endpoint handler" to locate handlers across services
FAQ
Run grepai workspace remove <workspace> /old/path then add the new path with grepai workspace add <workspace> /new/path.
Does deleting a workspace remove my project files?
No. Deleting a workspace removes its configuration and combined index but does not delete project source files.
16 skills
This skill helps you manage multi-project codebases with unified search across workspaces, enabling monorepos, microservices, and cross-project queries.
This skill configures Ollama as a private embedding provider for GrepAI, enabling fast, local code search with offline privacy.
This skill helps optimize code chunking for embeddings by tuning size and overlap to balance precision and context.
This skill enables semantic code search and call graph insights in Cursor by integrating GrepAI via MCP.
This skill guides you through installing and configuring Ollama for private local embeddings with GrepAI, ensuring offline code search.
This skill identifies all functions called by a target function using GrepAI trace to map dependencies and aid code understanding.
This skill guides you through installing, indexing, and searching code with GrepAI in minutes, accelerating setup and first queries.
This skill helps you understand GrepAI MCP tools, their parameters, and usage to integrate, debug, and optimize code search and call-graph tasks.
This skill teaches semantic code search basics with GrepAI, helping you perform basic queries, compare semantic versus text search, and interpret results.
This skill helps you craft effective GrepAI queries to improve search quality by describing intent, context, and domain-specific terms.
This skill guides you through installing GrepAI across macOS, Linux, and Windows, ensuring a successful setup and verification.
This skill enables Claude Code to perform semantic code search and call graph analysis via MCP integration with GrepAI, boosting coding insights.
This skill guides you through diagnosing and fixing common GrepAI issues, improving search reliability and indexing efficiently.
This skill configures GrepAI to use GOB local file storage for embeddings, metadata, and indexes, enabling simple single-machine setups.
This skill initializes GrepAI in a project by creating .grepai with default config and indices, then guides setup.
This skill helps teams configure PostgreSQL with pgvector for GrepAI, enabling scalable, concurrent, and persistent semantic code search across large codebases.
