Programowanie · Automatyzacja
grepai-init
/grepai-init
Inicjalizuje GrepAI w projekcie przy pierwszej konfiguracji wyszukiwania w bazie kodu.
Dla kogo
- Autor
- yoanbernabeu ↗
- Repozytorium
- grepai-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 30.10.2026
Ocena i bezpieczeństwo
100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 2
Przestarzałość
Brak sygnałów. Repozytorium zmienione 30.10.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Inicjalizuje GrepAI w projekcie przy pierwszej konfiguracji wyszukiwania w bazie kodu.
Oryginalny opis (EN)
Initialize GrepAI in a project. Use this skill when setting up GrepAI for the first time in a codebase.
Jak działa
- When to Use This Skill
- Basic Usage
- What Init Creates
- Default Configuration
- Understanding Default Settings
- Customizing After Init
- Init in Monorepos
- Re-Initialization
- Verifying Initialization
- Common Issues
Sekcje z nagłówków SKILL.md, w oryginale · 259 linii, 632 słów
Podgląd SKILL.md
---
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
```
Wersje
W bazie nie ma innych skilli o nazwie grepai-init.
Migawka bazy z 13.11.2026 · wersja paczki 2b00027fad86 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 95grepai-troubleshooting
Diagnozuje typowe problemy z narzędziem GrepAI i pokazuje, jak je naprawić. - 100grepai-config-reference
Opisuje wszystkie opcje konfiguracji GrepAI, żeby wiedzieć, co ustawić w danym projekcie. - 100grepai-repo-setup
Konfiguruje lub diagnozuje GrepAI dla jednego repozytorium Git we wspólnym workspace, w tym rejestrację projektu i indeks. - 100greppy-workspace
Konfiguruje i diagnozuje wspólne wyszukiwanie kodu między repozytoriami na lokalnym GrepAI oraz ograniczone rekordy ponownego użycia. - 100grepai
Wyszukuje kod semantycznie i śledzi graf wywołań, odpowiadając na pytania o intencję, na przykład gdzie obsługiwane jest uwierzytelnianie, jako warstwa rankingowa nad dokładnym Grep. - 100phx-init
Inicjalizuje plugin Elixir w projekcie, instalując Iron Laws i reguły aktywacji przy konfiguracji lub aktualizacji.