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

grepai-init — скилл для Claude Code: что делает и как установить

Скилл grepai-init обучает агента запускать инициализацию GrepAI в кодовой базе и настраивать файл .grepai/config.yaml. Помогает развернуть семантический поиск при первом знакомстве проекта с GrepAI.

MIT 733 установок ★ 20 обновлён 2026-10-30

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

Что делает grepai-init

Скилл инструктирует агента по шагам начальной настройки GrepAI в проекте. Команда grepai init создаёт в корне каталога папку .grepai/ с базовым файлом config.yaml. В дальнейшем процесс grepai watch генерирует в этой же папке бинарные файлы векторного индекса index.gob и таблицу символов symbols.gob для кодовой базы.

В сгенерированном файле конфигурации по умолчанию задана локальная модель nomic-embed-text через Ollama на http://localhost:11434. Без запущенной службы ollama serve сборка индекса завершится ошибкой. Скилл подсказывает, как переключить провайдер на OpenAI с переменной окружения OPENAI_API_KEY, изменить локальный бекенд gob на PostgreSQL или настроить раздельные воркспейсы в монорепозитории.

Для предотвращения раздувания индекса в настройках задан список игнорируемых папок, включая node_modules, vendor, build и dist. Каталог .grepai/ привязан к локальной машине, поэтому его требуется сразу добавить в .gitignore.

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

  • создать каталог .grepai/ с базовым конфигом
  • настроить локальный эмбеддер через Ollama или внешний через OpenAI
  • переключить хранилище векторных индексов с файлов gob на PostgreSQL
  • задать правила исключения файлов и папок для индексации

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

  • Инициализируй GrepAI в корне этого репозитория.
  • Переключи эмбеддинги в файле .grepai/config.yaml на модель OpenAI.
  • Сбрось конфигурацию GrepAI и заново создай каталог .grepai/.

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

1Через Skills CLI (Vercel)

npx skills add yoanbernabeu/grepai-skills --skill grepai-init -a claude-code

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

~/.claude/skills/grepai-init/SKILL.md

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

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

Вопросы о grepai-init

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

Выполните команду npx skills add yoanbernabeu/grepai-skills --skill grepai-init -a claude-code. Файл скилла будет сохранён по пути ~/.claude/skills/grepai-init/SKILL.md.

Какие файлы создаёт команда grepai init?

Команда создаёт каталог .grepai/ с конфигурационным файлом config.yaml. Позднее команда grepai watch добавит туда файлы векторного индекса index.gob и таблицы символов symbols.gob.

Что делать, если при запуске индексации не отвечает Ollama?

Конфигурация по умолчанию обращается к локальному API по адресу http://localhost:11434. Запустите сервер командой ollama serve либо переключите провайдер в .grepai/config.yaml на OpenAI.

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

SKILL.md · MIT
---
name: grepai-init
description: Initialize GrepAI in a project. Use this skill when setting up GrepAI for the first time in a codebase.
---

# GrepAI Init

This skill covers the `grepai init` command and project initialization.

## When to Use This Skill

- Setting up GrepAI in a new project
- Understanding what `grepai init` creates
- Customizing initial configuration
- Troubleshooting initialization issues

## Basic Usage

```bash
cd /path/to/your/project
grepai init
```

## What Init Creates

Running `grepai init` creates the `.grepai/` directory with:

```
.grepai/
├── config.yaml    # Configuration file
├── index.gob      # Vector index (created by watch)
└── symbols.gob    # Symbol index for trace (created by watch)
```

## Default Configuration

The generated `config.yaml`:

```yaml
version: 1

embedder:
  provider: ollama
  model: nomic-embed-text
  endpoint: http://localhost:11434

store:
  backend: gob

chunking:
  size: 512
  overlap: 50

watch:
  debounce_ms: 500

trace:
  enabled_languages:
    - .go
    - .js
    - .ts
    - .jsx
    - .tsx
    - .vue
    - .py
    - .php
    - .lua
    - .gd
    - .rb
    - .c
    - .h
    - .cpp
    - .hpp
    - .cc
    - .cxx
    - .hxx
    - .rs
    - .zig
    - .cs
    - .java
    - .fs
    - .fsx
    - .fsi
    - .pas
    - .dpr

ignore:
  - .git
  - .grepai
  - node_modules
  - vendor
  - target
  - __pycache__
  - dist
  - build
```

## Understanding Default Settings

### Embedder Settings

| Setting | Default | Purpose |
|---------|---------|---------|
| `provider` | `ollama` | Local embedding generation |
| `model` | `nomic-embed-text` | 768-dimension model |
| `endpoint` | `http://localhost:11434` | Ollama API URL |

### Store Settings

| Setting | Default | Purpose |
|---------|---------|---------|
| `backend` | `gob` | Local file storage |

### Chunking Settings

| Setting | Default | Purpose |
|---------|---------|---------|
| `size` | `512` | Tokens per chunk |
| `overlap` | `50` | Overlap for context |

### Watch Settings

| Setting | Default | Purpose |
|---------|---------|---------|
| `debounce_ms` | `500` | Wait time before re-indexing |

### Ignore Patterns

Default patterns exclude:
- Version control: `.git`
- GrepAI data: `.grepai`
- Dependencies: `node_modules`, `vendor`
- Build outputs: `target`, `dist`, `build`
- Cache: `__pycache__`

## Customizing After Init

Edit `.grepai/config.yaml` to customize:

### Change Embedding Provider

```yaml
embedder:
  provider: openai
  model: text-embedding-3-small
  # no api_key: read from OPENAI_API_KEY (official endpoint only)
```

### Change Storage Backend

```yaml
store:
  backend: postgres
  postgres:
    dsn: postgres://user:pass@localhost:5432/grepai
```

### Add Custom Ignore Patterns

```yaml
ignore:
  - .git
  - .grepai
  - node_modules
  - "*.min.js"
  - "*.bundle.js"
  - coverage/
  - .nyc_output/
```

## Init in Monorepos

For monorepos, init at the root:

```bash
cd /path/to/monorepo
grepai init
```

Or use workspaces for separate indices:

```bash
grepai workspace create my-workspace
grepai workspace add my-workspace /path/to/project1
grepai workspace add my-workspace /path/to/project2
```

## Re-Initialization

If you need to reset:

```bash
# Remove existing config
rm -rf .grepai

# Re-initialize
grepai init
```

**Warning:** This deletes your index. You'll need to re-run `grepai watch`.

## Verifying Initialization

After init, verify with:

```bash
# Check config exists
cat .grepai/config.yaml

# Check status (will show no index yet)
grepai status
```

## Common Issues

❌ **Problem:** `.grepai` already exists
✅ **Solution:** Delete it first or edit existing config:
```bash
rm -rf .grepai && grepai init
```

❌ **Problem:** Config created but Ollama not running
✅ **Solution:** Start Ollama before running `grepai watch`:
```bash
ollama serve
```

❌ **Problem:** Wrong directory initialized
✅ **Solution:** Remove `.grepai` and init in correct directory

## Best Practices

1. **Init at project root:** Where your main code lives
2. **Add `.grepai/` to `.gitignore`:** Index is machine-specific
3. **Customize ignore patterns:** Exclude generated/vendored code
4. **Review config after init:** Adjust for your stack

## Example .gitignore Addition

```gitignore
# GrepAI
.grepai/
```

## Output Format

After successful initialization:

```
✅ GrepAI Initialized

   Config: .grepai/config.yaml

   Default settings:
   - Embedder: Ollama (nomic-embed-text)
   - Storage: GOB (local file)
   - Chunking: 512 tokens, 50 overlap

   Next steps:
   1. Ensure Ollama is running: ollama serve
   2. Start indexing: grepai watch
```

© yoanbernabeu · MIT · yoanbernabeu/grepai-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
lumen Ory Corp Плагин lumen для Claude Code ищет фрагменты кода по смыслу через MCP. Он подключает локальный индекс, когда агенту нужно найти нужную реализацию в проекте. ★ 317звёзд репо cli-anything-ollama HKUDS Скилл cli-anything-ollama для Claude Code управляет моделями Ollama и запускает генерацию текста, чаты и эмбеддинги. Агент использует его для работы с Ollama через командную строку. CX Codex +1 616установок ivygrep bvolpato ivygrep — MCP-сервер для Claude Code: локально ищет код и собирает контекст задач. Упаковывает связанные функции, тесты и Git-диффы в Markdown в пределах лимита токенов. CX Codex +1 ★ 7звёзд репо Infimium infimium-ai Infimium — MCP-сервер для локального контекста: агент ищет код по смыслу, видит граф зависимостей и сохраняет ход работы на вашей машине. CX Codex +1 ★ 26звёзд репо token-compressor base76-research-lab MCP-сервер token-compressor сжимает промпты на 40–60% через локальную модель и проверяет сохранность смысла эмбеддингами перед отправкой текста в агент. CX Codex +1 ★ 12звёзд репо claude-find Cavinooo MCP-сервер claude-find ищет по исходным логам прошлых сессий Claude Code через векторные эмбеддинги и FTS5, помогая вспомнить принятые решения и ошибки. CX Codex +1 ★ 12звёзд репо

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

Весь набор →
grepai-search-boosting Скилл grepai-search-boosting настраивает бусты и штрафы в GrepAI, чтобы исходники поднимались выше тестов, документации и вендорного кода. CX Codex +1 787установок grepai-mcp-tools Скилл grepai-mcp-tools для Claude Code описывает пять инструментов GrepAI для поиска по коду, построения графов вызовов и проверки статуса индекса. CX Codex +1 753установок grepai-languages Скилл grepai-languages передаёт агенту правила индексации языков и настройки графов вызовов в GrepAI. Помогает настроить семантический поиск и разобрать связи между функциями в проекте. CX Codex +1 742установок grepai-chunking Скилл grepai-chunking настраивает правила разбиения исходного кода на фрагменты в GrepAI. Помогает сбалансировать размер чанков и контекст при семантическом поиске по репозиторию. CX Codex +1 738установок grepai-watch-daemon Скилл grepai-watch-daemon учит агента запускать и настраивать демон grepai watch: первичная индексация проекта, слежение за файлами, фоновый режим и разбор сбоев. CX Codex +1 732установок 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установок

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

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