К основному содержанию
скилл CX Codex

grepai-storage-gob — скилл для Claude Code

Скилл grepai-storage-gob настраивает локальное хранилище GOB для GrepAI без внешних баз данных. Пригодится соло-разработчикам на небольших проектах до 10 000 файлов.

MIT 701 установок ★ 20 обновлён 2026-02-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a claude-code
Открыть на GitHub

Что делает grepai-storage-gob

GrepAI использует бинарную сериализацию Go (GOB) как стандартный бэкенд для локального семантического поиска. Скилл помогает составить конфиг .grepai/config.yaml и настроить генерацию эмбеддингов через grepai watch. Все векторы, метаданные и чанки сохраняются локально в директории .grepai/ внутри файлов index.gob и symbols.gob.

При поиске GrepAI загружает индекс целиком в оперативную память: файлу на 50 МБ потребуется около 100 МБ RAM. Поэтому для репозиториев свыше 50 000 файлов или при размере индекса больше 1 ГБ бэкенд GOB не подойдёт — придётся мигрировать на PostgreSQL или Qdrant. Индекс привязан к локальным путям и конкретной модели эмбеддингов, так что передавать файл index.gob между разными машинами нельзя.

Какие задачи решает

  • настроить локальный бэкенд GOB в файле .grepai/config.yaml
  • оценить потребление оперативной памяти при индексации репозитория
  • сделать резервную копию или пересоздать повреждённый index.gob
  • перенести проект с GOB на внешние базы PostgreSQL или Qdrant

Примеры запросов агенту

  • Настрой конфиг grepai для работы с локальным хранилищем gob в этом проекте.
  • Проверь статус индекса grepai и скажи, сколько RAM уйдёт на поиск.
  • Покажи параметры конфигурации для переезда с gob на postgresql.

Как установить grepai-storage-gob

1Через Skills CLI (Vercel)

npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a claude-code

2Вручную: положить файлы

~/.claude/skills/grepai-storage-gob/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/grepai-storage-gob/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о grepai-storage-gob

Как установить grepai-storage-gob в Claude Code?

Выполните команду npx skills add yoanbernabeu/grepai-skills --skill grepai-storage-gob -a claude-code. Либо вручную скопируйте файл по пути ~/.claude/skills/grepai-storage-gob/SKILL.md.

Что делает grepai-storage-gob?

Скилл передаёт агенту правила настройки и обслуживания бинарного хранилища GOB в GrepAI. В него входят примеры конфигурации, расчёт расхода RAM и команды сброса индекса.

Почему нельзя коммитить каталог .grepai в Git?

Бинарный файл index.gob хранит абсолютные пути к файлам текущей системы и зависит от локальной модели эмбеддингов. Каждый разработчик должен создать собственный индекс через grepai watch, добавив .grepai/ в .gitignore.

Исходный текст

SKILL.md · MIT
---
name: grepai-storage-gob
description: Configure GOB local file storage for GrepAI. Use this skill for simple, single-machine setups.
---

# GrepAI Storage with GOB

This skill covers using GOB (Go Binary) as the storage backend for GrepAI, the default and simplest option.

## When to Use This Skill

- Single developer projects
- Small to medium codebases
- Simple setup without external dependencies
- Local development environments

## What is GOB Storage?

GOB is Go's native binary serialization format. GrepAI uses it to store:
- Vector embeddings
- File metadata
- Chunk information

Everything is stored in a single local file.

## Advantages

| Benefit | Description |
|---------|-------------|
| 🚀 **Simple** | No external services needed |
| ⚡ **Fast setup** | Works immediately |
| 📁 **Portable** | Single file, easy to backup |
| 💰 **Free** | No infrastructure costs |
| 🔒 **Private** | Data stays local |

## Limitations

| Limitation | Description |
|------------|-------------|
| 📏 **Scalability** | Not ideal for very large codebases |
| 👤 **Single user** | No concurrent access |
| 🔄 **No sharing** | Can't share index across machines |
| 💾 **Memory** | Loads into RAM for searches |

## Configuration

### Default Configuration

GOB is the default backend. Minimal config:

```yaml
# .grepai/config.yaml
store:
  backend: gob
```

### Explicit Configuration

```yaml
store:
  backend: gob
  # Index stored in .grepai/index.gob (automatic)
```

## Storage Location

GOB storage creates files in your project's `.grepai/` directory:

```
.grepai/
├── config.yaml    # Configuration
├── index.gob      # Vector embeddings
└── symbols.gob    # Symbol index for trace
```

## File Sizes

Approximate `.grepai/index.gob` sizes:

| Codebase | Files | Chunks | Index Size |
|----------|-------|--------|------------|
| Small | 100 | 500 | ~5 MB |
| Medium | 1,000 | 5,000 | ~50 MB |
| Large | 10,000 | 50,000 | ~500 MB |

## Operations

### Creating the Index

```bash
# Initialize project
grepai init

# Start indexing (creates index.gob)
grepai watch
```

### Checking Index Status

```bash
grepai status

# Output:
# Index: .grepai/index.gob
# Files: 245
# Chunks: 1,234
# Size: 12.5 MB
# Last updated: 2025-01-28 10:30:00
```

### Backing Up the Index

```bash
# Simple file copy
cp .grepai/index.gob .grepai/index.gob.backup
```

### Clearing the Index

```bash
# Delete and re-index
rm .grepai/index.gob
grepai watch
```

### Moving to a New Machine

```bash
# Copy entire .grepai directory
cp -r .grepai /path/to/new/location/

# Note: Only works if using same embedding model
```

## Performance Considerations

### Memory Usage

GOB loads the entire index into RAM for searches:

| Index Size | RAM Usage |
|------------|-----------|
| 10 MB | ~20 MB |
| 50 MB | ~100 MB |
| 500 MB | ~1 GB |

### Search Speed

GOB provides fast searches for typical codebases:

| Codebase Size | Search Time |
|---------------|-------------|
| Small (100 files) | <50ms |
| Medium (1K files) | <200ms |
| Large (10K files) | <1s |

### When to Upgrade

Consider PostgreSQL or Qdrant when:
- Index exceeds 1 GB
- Need concurrent access
- Want to share index across team
- Codebase has 50K+ files

## .gitignore Configuration

Add `.grepai/` to your `.gitignore`:

```gitignore
# GrepAI (machine-specific index)
.grepai/
```

**Why:** The index is machine-specific because:
- Contains binary embeddings
- Tied to the embedding model used
- Each machine should generate its own

## Sharing Index (Not Recommended)

While you can copy the index file, it's not recommended because:
1. Must use identical embedding model
2. File paths are absolute
3. Different machines may have different code versions

**Better approach:** Each developer runs their own `grepai watch`.

## Migrating to Other Backends

### To PostgreSQL

1. Update config:
```yaml
store:
  backend: postgres
  postgres:
    dsn: postgres://user:pass@localhost:5432/grepai
```

2. Re-index:
```bash
rm .grepai/index.gob
grepai watch
```

### To Qdrant

1. Update config:
```yaml
store:
  backend: qdrant
  qdrant:
    endpoint: localhost
    port: 6334
```

2. Re-index:
```bash
rm .grepai/index.gob
grepai watch
```

## Common Issues

❌ **Problem:** Index file too large
✅ **Solution:** Add more ignore patterns or migrate to PostgreSQL/Qdrant

❌ **Problem:** Slow searches on large codebase
✅ **Solution:** Migrate to Qdrant for better performance

❌ **Problem:** Corrupted index
✅ **Solution:** Delete and re-index:
```bash
rm .grepai/index.gob .grepai/symbols.gob
grepai watch
```

❌ **Problem:** "Index not found" error
✅ **Solution:** Run `grepai watch` to create the index

## Best Practices

1. **Use for small/medium projects:** Up to ~10K files
2. **Add to .gitignore:** Don't commit the index
3. **Backup before major changes:** Copy index.gob before experiments
4. **Re-index after model changes:** If you change embedding models
5. **Monitor file size:** Migrate if index exceeds 1GB

## Output Format

GOB storage status:

```
✅ GOB Storage Configured

   Backend: GOB (local file)
   Index: .grepai/index.gob
   Size: 12.5 MB

   Contents:
   - Files: 245
   - Chunks: 1,234
   - Vectors: 1,234 × 768 dimensions

   Performance:
   - Search latency: <100ms
   - Memory usage: ~25 MB
```

© yoanbernabeu · MIT · yoanbernabeu/grepai-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
google-cloud-storage-fuse официальный google Скилл google-cloud-storage-fuse помогает решать, нужен ли gcsfuse, настраивать монтирование Cloud Storage и разбирать проблемы с производительностью и расходами. CX Codex +1 3 900установок mongodb-search-and-ai mongodb Скилл mongodb-search-and-ai для Claude Code и Codex: полнотекстовый поиск в MongoDB (Atlas Search), семантический поиск по смыслу (Vector Search) и гибридный поиск. CX Codex +1 6 300установок vector-search ruvnet Скилл vector-search выполняет векторный поиск по документам через HNSW или маршрутизирует запросы по 11 шаблонам в WASM. CX Codex +1 752установок vector-embed ruvnet Скилл vector-embed превращает строку текста или содержимое файла в 384-мерный вектор через ruvector и держит его в HNSW-индексе для поиска по смыслу. CX Codex +1 732установок vector-search-workflows Claude MPM Team Скилл vector-search-workflows для Claude Code описывает настройку семантического поиска по кодовой базе через MCP Vector Search. Включает индексацию, поиск и обновление индекса. CX Codex +1 332установок Vector Search — In-Memory TF-IDF Semantic Store axel-belfort MCP-сервер Vector Search — In-Memory TF-IDF Semantic Store для Claude Code ищет семантические совпадения в небольших наборах документов с помощью TF-IDF и косинусного сходства в оперативной памяти. CX Codex +1 3 562установок

Из того же набора23

Весь набор →
grepai-troubleshooting Скилл grepai-troubleshooting помогает найти причину сбоев GrepAI: пустой или устаревший индекс, плохие результаты поиска, ошибки подключения и конфигурации. CX Codex +1 727установок grepai-config-reference Скилл grepai-config-reference описывает все параметры файла .grepai/config.yaml — эмбеддер, хранилище, чанкинг, трассировку вызовов и правила игнорирования. CX Codex +1 727установок grepai-workspaces Скилл grepai-workspaces настраивает мультипроектные воркспейсы GrepAI с общим векторным хранилищем для монорепо и связанных сервисов. Агент сам разбирается с индексацией и поиском по нескольким проектам сразу. CX Codex +1 721установок grepai-ignore-patterns Скилл grepai-ignore-patterns помогает настроить исключения в .grepai/config.yaml, чтобы GrepAI не тратил ресурсы на тесты, кэш и сгенерированный код при индексации. CX Codex +1 712установок grepai-mcp-claude Скилл grepai-mcp-claude для Claude Code подключает GrepAI через MCP и включает семантический поиск по коду. Запускается при настройке сервера или поиске причин сбоев интеграции. CX Codex +1 618установок grepai-mcp-cursor Скилл помогает настроить интеграцию GrepAI с Cursor через MCP для семантического поиска по коду и построения графа вызовов. CX Codex +1 601установок grepai-storage-qdrant Скилл grepai-storage-qdrant настраивает векторную базу данных Qdrant в роли хранилища для поискового движка GrepAI. Инструкция подключает локальный Docker-контейнер или кластер Qdrant Cloud через gRPC на порту 6334. CX Codex +1 570установок grepai-embeddings-lmstudio Скилл grepai-embeddings-lmstudio для Claude Code: подключает LM Studio как провайдер эмбеддингов для GrepAI. Даёт локальные модели с графическим интерфейсом вместо командной строки. CX Codex +1 568установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой