grepai-workspaces

Q: How do I install grepai-workspaces?

Run npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-workspaces in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/grepai-workspaces/ (personal) or .claude/skills/grepai-workspaces/ (project).

by yoanbernabeu

Configure multi-project workspaces in GrepAI. Use this skill for monorepos and multiple related projects.

Installs: 685
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-workspaces

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads grepai-workspaces automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

grepai workspace create my-workspace

Output:

✅ Workspace 'my-workspace' created
   Location: ~/.grepai/workspaces/my-workspace/

   Next: Add projects with 'grepai workspace add'

Adding Projects

# 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

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

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

# 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

grepai watch --workspace my-workspace --background

Searching Workspaces

Search All Projects

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

grepai search --workspace my-workspace --project frontend "form validation"

Only searches the frontend project.

Workspace Status

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

grepai workspace remove my-workspace /path/to/old-project

Deleting a Workspace

grepai workspace delete my-workspace

This removes the workspace configuration but NOT the project files.

Workspace Configuration

Workspaces store config in ~/.grepai/workspaces/<name>/:

~/.grepai/workspaces/my-workspace/
├── workspace.yaml    # Workspace config
├── index.gob         # Combined index
└── symbols.gob       # Combined symbols

workspace.yaml

name: my-workspace
created: 2025-01-28T10:00:00Z

projects:
  - name: frontend
    path: /path/to/frontend
  - name: backend
    path: /path/to/backend
  - name: shared-lib
    path: /path/to/shared-lib

# Optional: override global config per workspace
embedder:
  provider: ollama
  model: nomic-embed-text

ignore:
  - node_modules
  - dist

MCP with Workspaces

Use workspaces with MCP servers:

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve", "--workspace", "my-workspace"]
    }
  }
}

Use Cases

Monorepo

# Full monorepo
grepai workspace create monorepo
grepai workspace add monorepo /path/to/monorepo/apps/web
grepai workspace add monorepo /path/to/monorepo/apps/mobile
grepai workspace add monorepo /path/to/monorepo/packages/ui
grepai workspace add monorepo /path/to/monorepo/packages/core

Microservices

# Related microservices
grepai workspace create services
grepai workspace add services /path/to/user-service
grepai workspace add services /path/to/order-service
grepai workspace add services /path/to/payment-service
grepai workspace add services /path/to/notification-service

Frontend + Backend

# Full stack
grepai workspace create fullstack
grepai workspace add fullstack /path/to/frontend
grepai workspace add fullstack /path/to/backend
grepai workspace add fullstack /path/to/shared-types

Cross-Project Search Examples

Find All API Endpoints

grepai search --workspace services "REST API endpoint handler"

Find Shared Type Usage

grepai search --workspace fullstack "User interface definition"

Find Cross-Project Dependencies

# What calls the shared auth library?
grepai trace callers --workspace fullstack "validateToken"

Best Practices

Name descriptively: ecommerce-stack not ws1
Group related projects: Only projects that you'd search together
One daemon per workspace: Run grepai watch --workspace
Use project filter: When you know which project to search
Update after major changes: Re-index after adding/removing files

Common Issues

❌ Problem: Workspace not found ✅ Solution: Check workspace exists: grepai workspace list

❌ Problem: Project paths changed ✅ Solution: Remove old path, add new path:

grepai workspace remove my-workspace /old/path
grepai workspace add my-workspace /new/path

❌ Problem: Search returns mixed results ✅ Solution: Use --project flag to filter:

grepai search --workspace ws --project backend "query"

Output Format

Workspace overview:

📁 Workspace: my-workspace

Configuration:
- Location: ~/.grepai/workspaces/my-workspace/
- Created: 2025-01-28

Projects (3):
┌─────────────┬──────────────────────────┬───────┐
│ Name        │ Path                      │ Files │
├─────────────┼──────────────────────────┼───────┤
│ frontend    │ /path/to/frontend        │ 450   │
│ backend     │ /path/to/backend         │ 320   │
│ shared-lib  │ /path/to/shared-lib      │ 85    │
└─────────────┴──────────────────────────┴───────┘

Commands:
- Index: grepai watch --workspace my-workspace
- Search: grepai search --workspace my-workspace "query"
- Status: grepai workspace status my-workspace

FAQ

What does the grepai-workspaces skill do?

Configure multi-project workspaces in GrepAI. Use this skill for monorepos and multiple related projects.

How do I install grepai-workspaces?

Run npx skills add https://github.com/yoanbernabeu/grepai-skills --skill grepai-workspaces in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/grepai-workspaces/ (personal) or .claude/skills/grepai-workspaces/ (project).

Which AI agents can use grepai-workspaces?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is grepai-workspaces safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains grepai-workspaces?

It is published by yoanbernabeu in yoanbernabeu/grepai-skills. It has 685 recorded installs.

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs

grepai-workspaces

Install

Install

Describe the task

Review the result

SKILL.md

GrepAI Workspaces

When to Use This Skill

What are Workspaces?

Creating a Workspace

Adding Projects

Listing Workspaces

Viewing Workspace Details

Indexing a Workspace

Background Indexing

Searching Workspaces

Search All Projects

Search Specific Project

Workspace Status

Removing Projects from Workspace

Deleting a Workspace

Workspace Configuration

workspace.yaml

MCP with Workspaces

Use Cases

Monorepo

Microservices

Frontend + Backend

Cross-Project Search Examples

Find All API Endpoints

Find Shared Type Usage

Find Cross-Project Dependencies

Best Practices

Common Issues

Output Format

FAQ

More from yoanbernabeu/grepai-skills

Popular other skills