GrepAI Init Skill | Agent Skills

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

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:

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:
  mode: fast
  enabled_languages:
    - .go
    - .js
    - .ts
    - .jsx
    - .tsx
    - .py
    - .php
    - .c
    - .h
    - .cpp
    - .hpp
    - .cc
    - .cxx
    - .rs
    - .zig
    - .cs
    - .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

embedder:
  provider: openai
  model: text-embedding-3-small
  api_key: ${OPENAI_API_KEY}

Change Storage Backend

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

Add Custom Ignore Patterns

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

Init in Monorepos

For monorepos, init at the root:

cd /path/to/monorepo
grepai init

Or use workspaces for separate indices:

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:

# 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:

# 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:

rm -rf .grepai && grepai init

❌ Problem: Config created but Ollama not running ✅ Solution: Start Ollama before running grepai watch:

ollama serve

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

Best Practices

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

Example .gitignore Addition

# 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

Agent Skills: GrepAI Init

Install this agent skill to your local

Skill Files