# grepai-config-reference

Скилл-шпаргалка по всем параметрам .grepai/config.yaml: эмбеддер, хранилище, чанки, поиск. Пригодится, когда нужно понять опцию или починить конфиг.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 688 установок · ★ 21
- Автор: yoanbernabeu
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/yoanbernabeu/grepai-skills/tree/HEAD/skills/configuration/grepai-config-reference/SKILL.md
- Обновлён: 2026-02-01
- HTML: https://affpapa.org/nevibecode/skills/grepai-config-reference

## Что делает

Скилл открывает агенту полную схему конфигурации GrepAI из файла `.grepai/config.yaml`. Внутри разобраны блоки `embedder` (провайдеры `ollama`, `openai`, `lmstudio`, модель, endpoint, размерность, ключ, параллелизм), `store` (`gob`, `postgres`, `qdrant`), `chunking` с размером и перекрытием чанков, `watch` с задержкой дебаунса, `trace` с режимами `fast` и `precise`, `search` с бустами и гибридным поиском, а также список `ignore`.

Кроме схемы в скилле есть готовые наборы настроек под разные случаи: маленький личный проект, большая кодовая база, командная работа, максимальная приватность. Отдельно описана подстановка переменных окружения — например, `api_key: ${OPENAI_API_KEY}` и `dsn: ${DATABASE_URL}`. Проверить, что конфиг корректен, можно командой `grepai status`: ошибки она покажет.

Порядок приоритета такой: сначала `.grepai/config.yaml` в текущей папке, потом конфигурация workspace, потом значения по умолчанию. Если GrepAI не установлен или вы ещё не завели конфиг, скиллу нечего будет объяснять — это повод сначала поставить сам инструмент. Ключи API скилл советует держать в переменных окружения и не коммитить.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-config-reference -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/grepai-config-reference/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/grepai-config-reference/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-config-reference -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/grepai-config-reference/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-config-reference -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/grepai-config-reference/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install yoanbernabeu/grepai-skills grepai-config-reference
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/grepai-config-reference/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-config-reference -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/yoanbernabeu/grepai-skills --path skills/configuration/grepai-config-reference
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/grepai-config-reference/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add yoanbernabeu/grepai-skills --skill grepai-config-reference -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/yoanbernabeu/grepai-skills/tree/HEAD/skills/configuration/grepai-config-reference/SKILL.md

## Когда брать
- разобраться, какие параметры вообще есть в `.grepai/config.yaml`
- выбрать провайдера эмбеддингов и подходящую модель
- переключить хранилище векторов с `gob` на `postgres` или `qdrant`
- настроить бусты и штрафы, чтобы тесты и `vendor` не лезли в выдачу
- подставить ключ API через переменную окружения вместо хардкода

## Примеры запросов агенту
- Покажи все опции конфигурации GrepAI и объясни, что делает каждая
- Как настроить `.grepai/config.yaml` для большой кодовой базы?
- Почему `grepai status` ругается на мой конфиг?

## Похожие
- [config-codex-cli](https://affpapa.org/nevibecode/skills/config-codex-cli.md) — скилл · 990 установок
- [V3 Memory Unification](https://affpapa.org/nevibecode/skills/v3-memory-unification.md) — скилл · 1100 установок
- [vector-search](https://affpapa.org/nevibecode/skills/vector-search.md) — скилл · 751 установка
- [docker-agent-config](https://affpapa.org/nevibecode/skills/docker-agent-config.md) — скилл · 746 установок
- [embedding-strategies](https://affpapa.org/nevibecode/skills/embedding-strategies.md) — скилл · 11391 установка
- [storing-and-querying-vectors](https://affpapa.org/nevibecode/skills/storing-and-querying-vectors.md) — скилл · 6600 установок

Из того же набора: [yoanbernabeu/grepai-skills](https://affpapa.org/nevibecode/by/yoanbernabeu/grepai-skills.md) — 12 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md