Grepai Workspaces
Group monorepo or microservice repos into one GrepAI workspace so semantic search and watch indexing span every related project.
Overview
grepai-workspaces is an agent skill for the Build phase that configures multi-project GrepAI workspaces for unified indexing and cross-repo search.
Install
npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-workspacesWhat is this skill?
- Create named workspaces with grepai workspace create
- Add multiple project paths via grepai workspace add for monorepos and microservices
- List workspaces and project counts with grepai workspace list
- Unified cross-project search index with optional per-project scoping
- Shared configuration across projects in one workspace
Adoption & trust: 482 installs on skills.sh; 17 GitHub stars; 3/3 security scanners passed (skills.sh audits); trending (+100% hot-view momentum).
What problem does it solve?
You have several related code folders but agent search only sees one repo at a time, slowing navigation in monorepos and microservice layouts.
Who is it for?
Indie builders using GrepAI with monorepos, multi-package frontends and backends, or microservices that need one search index.
Skip if: Single-repo projects with no GrepAI installed, or teams that only need local ripgrep without semantic indexing.
When should I use this skill?
Working with monorepos, searching across multiple related projects, managing microservices architecture, or organizing large codebases with GrepAI.
What do I get? / Deliverables
A named GrepAI workspace lists all project paths and is ready for grepai watch --workspace to index every member for unified search.
- Created workspace under ~/.grepai/workspaces/
- Project manifest ready for grepai watch --workspace indexing
Recommended Skills
Journey fit
Workspace setup is agent-side codebase infrastructure you configure while building and maintaining multi-repo products, not a launch or growth task. GrepAI is tooling that augments how your coding agent searches and indexes code—canonical placement is agent-tooling within Build.
How it compares
Workspace orchestration for GrepAI—not a replacement for git submodules or your CI monorepo build graph.
Common Questions / FAQ
Who is grepai-workspaces for?
Developers and coding agents standardizing GrepAI across multiple directories in one monorepo or related service repos.
When should I use grepai-workspaces?
During Build when you adopt GrepAI for monorepos, microservices, or any time you need to search and index several projects under one workspace name.
Is grepai-workspaces safe to install?
The skill documents CLI commands that touch local paths and GrepAI config under ~/.grepai; check the Security Audits panel on this page and review what watch indexes before enabling on sensitive repos.
SKILL.md
READMESKILL.md - Grepai Workspaces
# GrepAI Workspaces This skill covers using GrepAI workspaces to manage multiple related projects with a unified search index. ## When to Use This Skill - Working with monorepos - Searching across multiple related projects - Managing microservices architecture - Organizing large codebases ## What are Workspaces? Workspaces allow you to: - Group multiple projects together - Search across all projects at once - Or search specific projects within the workspace - Share configuration across projects ## Creating a Workspace ```bash grepai workspace create my-workspace ``` Output: ``` ✅ Workspace 'my-workspace' created Location: ~/.grepai/workspaces/my-workspace/ Next: Add projects with 'grepai workspace add' ``` ## Adding Projects ```bash # Add first project grepai workspace add my-workspace /path/to/frontend # Add more projects grepai workspace add my-workspace /path/to/backend grepai workspace add my-workspace /path/to/shared-lib ``` Output: ``` ✅ Added '/path/to/frontend' to workspace 'my-workspace' Projects in workspace: 1. frontend (/path/to/frontend) Run 'grepai watch --workspace my-workspace' to index all projects. ``` ## Listing Workspaces ```bash grepai workspace list ``` Output: ``` 📁 Workspaces 1. my-workspace - Projects: 3 - Status: Not indexed 2. work-projects - Projects: 5 - Status: Indexed (updated 2h ago) ``` ## Viewing Workspace Details ```bash grepai workspace show my-workspace ``` Output: ``` 📁 Workspace: my-workspace Projects: 1. frontend Path: /path/to/frontend Files: 450 Last indexed: 2025-01-28 10:30 2. backend Path: /path/to/backend Files: 320 Last indexed: 2025-01-28 10:30 3. shared-lib Path: /path/to/shared-lib Files: 85 Last indexed: 2025-01-28 10:30 Total: 855 files, 4,200 chunks ``` ## Indexing a Workspace ```bash # Index all projects in workspace grepai watch --workspace my-workspace ``` Output: ``` 🔍 Indexing workspace 'my-workspace' [1/3] frontend... Found 450 files, 2,100 chunks [2/3] backend... Found 320 files, 1,500 chunks [3/3] shared-lib... Found 85 files, 600 chunks Total: 855 files, 4,200 chunks indexed Watching for changes... ``` ### Background Indexing ```bash grepai watch --workspace my-workspace --background ``` ## Searching Workspaces ### Search All Projects ```bash grepai search --workspace my-workspace "user authentication" ``` Results include project context: ``` Score: 0.89 | [backend] src/auth/middleware.go:15-45 ────────────────────────────────────────── func AuthMiddleware() ... Score: 0.85 | [frontend] src/hooks/useAuth.ts:10-30 ────────────────────────────────────────── export function useAuth() ... Score: 0.78 | [shared-lib] src/types/auth.ts:5-25 ────────────────────────────────────────── export interface AuthState ... ``` ### Search Specific Project ```bash grepai search --workspace my-workspace --project frontend "form validation" ``` Only searches the frontend project. ## Workspace Status ```bash grepai workspace status my-workspace ``` Output: ``` 📊 Workspace Status: my-workspace Projects: 3 Total files: 855 Total chunks: 4,200 Index size: 45 MB Per-project breakdown: ┌─────────────┬───────┬────────┬──────────┐ │ Project │ Files │ Chunks │ Updated │ ├─────────────┼───────┼────────┼──────────┤ │ frontend │ 450 │ 2,100 │ 2h ago │ │ backend │ 320 │ 1,500 │ 2h ago │ │ shared-lib │ 85 │ 600 │ 2h ago │ └─────────────┴───────┴────────┴──────────┘ Daemon: Running (PID 12345) ``` ## Removing Projects from Workspace ```bash grepai workspace remove my-workspace /path/to/old-project ``` ## Deleting a Workspace ```bash grepai workspace delete my-workspace ``` This removes the workspace configuration but NOT the project files. ## Workspace Configuration Wo