GrepAI工作空间使用指南：统一索引管理多项目代码库与微服务架构

grepai-workspaces by yoanbernabeu/grepai-skills

248 周安装量

15 GitHub Stars

GitHub

安装命令

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

开发代码质量开发运维

🇨🇳中文介绍

GrepAI 工作空间

此技能涵盖使用 GrepAI 工作空间来管理多个相关项目，并拥有统一的搜索索引。

何时使用此技能

处理单体仓库
跨多个相关项目进行搜索
管理微服务架构
组织大型代码库

什么是工作空间？

工作空间允许您：

将多个项目分组在一起
一次性在所有项目中搜索
或在工作空间内搜索特定项目
在项目间共享配置

创建工作空间

grepai workspace create my-workspace

输出：

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

   Next: Add projects with 'grepai workspace add'

添加项目

# 添加第一个项目
grepai workspace add my-workspace /path/to/frontend

# 添加更多项目
grepai workspace add my-workspace /path/to/backend
grepai workspace add my-workspace /path/to/shared-lib

输出：

✅ 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.

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

查看工作空间详情

grepai workspace show my-workspace

📁 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

为工作空间建立索引

# 为工作空间中的所有项目建立索引
grepai watch --workspace my-workspace

🔍 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...

grepai watch --workspace my-workspace --background

grepai search --workspace my-workspace "user authentication"

结果包含项目上下文：

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 ...

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

仅搜索 frontend 项目。

grepai workspace status my-workspace

📊 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)

从工作空间中移除项目

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

grepai workspace delete my-workspace

此操作会移除工作空间配置，但不会删除项目文件。

工作空间将配置存储在 ~/.grepai/workspaces/<name>/ 目录下：

~/.grepai/workspaces/my-workspace/
├── workspace.yaml    # 工作空间配置
├── index.gob         # 合并的索引
└── symbols.gob       # 合并的符号

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

# 可选：为每个工作空间覆盖全局配置
embedder:
  provider: ollama
  model: nomic-embed-text

ignore:
  - node_modules
  - dist

与 MCP 配合使用工作空间

与 MCP 服务器一起使用工作空间：

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

# 完整的单体仓库
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

# 相关的微服务
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

# 全栈
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

跨项目搜索示例

查找所有 API 端点

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

查找共享类型的使用

grepai search --workspace fullstack "User interface definition"

查找跨项目依赖

# 谁调用了共享的认证库？
grepai trace callers --workspace fullstack "validateToken"

描述性命名： 使用 ecommerce-stack 而不是 ws1
分组相关项目： 仅将您会一起搜索的项目分组
每个工作空间一个守护进程： 运行 grepai watch --workspace
使用项目过滤器： 当您知道要搜索哪个项目时
重大变更后更新： 添加/删除文件后重新建立索引

❌ 问题： 找不到工作空间 ✅ 解决方案： 检查工作空间是否存在：grepai workspace list

❌ 问题： 项目路径已更改 ✅ 解决方案： 移除旧路径，添加新路径：

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

❌ 问题： 搜索返回混合结果 ✅ 解决方案： 使用 --project 标志进行过滤：

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

工作空间概览：

📁 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

🇺🇸English

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

Weekly Installs

248

Repository

yoanbernabeu/gr…i-skills

GitHub Stars

First Seen

Jan 28, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

opencode198

codex193

gemini-cli178

github-copilot177

kimi-cli165

amp163

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

106,200 周安装

GrepAI工作空间使用指南：统一索引管理多项目代码库与微服务架构

🇨🇳中文介绍

GrepAI 工作空间

何时使用此技能

什么是工作空间？

创建工作空间

添加项目

相关 Skills

列出工作空间

查看工作空间详情

为工作空间建立索引

后台索引

搜索工作空间

搜索所有项目

搜索特定项目

工作空间状态

从工作空间中移除项目

删除工作空间

工作空间配置

workspace.yaml

与 MCP 配合使用工作空间

使用案例

单体仓库

微服务

前端 + 后端

跨项目搜索示例

查找所有 API 端点

查找共享类型的使用

查找跨项目依赖

最佳实践

常见问题

输出格式

🇺🇸English

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

最新 Skills