GrepAI Init

このスキルは grepai init コマンドとプロジェクト初期化に関するものです。

このスキルを使用する場合

• 新しいプロジェクトで GrepAI をセットアップする
• grepai init が何を作成するかを理解する
• 初期設定をカスタマイズする
• 初期化の問題をトラブルシューティングする

基本的な使用方法

cd /path/to/your/project
grepai init

Init が作成するもの

grepai init を実行すると、.grepai/ ディレクトリが作成されます：

.grepai/
├── config.yaml    # 設定ファイル
├── index.gob      # ベクトルインデックス (watch によって作成)
└── symbols.gob    # トレース用シンボルインデックス (watch によって作成)

デフォルト設定

生成される 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

デフォルト設定を理解する

Embedder 設定

設定	デフォルト	用途
provider	ollama	ローカル埋め込み生成
model	nomic-embed-text	768 次元モデル
endpoint	http://localhost:11434	Ollama API URL

Store 設定

設定	デフォルト	用途
backend	gob	ローカルファイルストレージ

Chunking 設定

設定	デフォルト	用途
size	512	チャンクあたりのトークン数
overlap	50	コンテキスト用のオーバーラップ

Watch 設定

設定	デフォルト	用途
debounce_ms	500	再インデックス前の待機時間

無視パターン

デフォルトパターンは以下を除外します：

• バージョン管理：.git
• GrepAI データ：.grepai
• 依存関係：node_modules、vendor
• ビルド出力：target、dist、build
• キャッシュ：__pycache__

Init の後でカスタマイズする

.grepai/config.yaml を編集してカスタマイズします：

Embedding プロバイダを変更

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

ストレージバックエンドを変更

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

カスタム無視パターンを追加

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

モノレポでの Init

モノレポの場合は、ルートで init を実行します：

cd /path/to/monorepo
grepai init

または、別々のインデックスに対してワークスペースを使用します：

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

再初期化

リセットが必要な場合：

# 既存の設定を削除
rm -rf .grepai

# 再初期化
grepai init

警告： これはインデックスを削除します。grepai watch を再度実行する必要があります。

初期化を検証する

Init の後、以下で検証します：

# 設定が存在することを確認
cat .grepai/config.yaml

# ステータスを確認 (まだインデックスがないことが表示されます)
grepai status

よくある問題

❌ 問題： .grepai は既に存在しています ✅ 解決策： 最初に削除するか、既存の設定を編集します：

rm -rf .grepai && grepai init

❌ 問題： 設定は作成されたが Ollama が実行されていない ✅ 解決策： grepai watch を実行する前に Ollama を起動します：

ollama serve

❌ 問題： 間違ったディレクトリで初期化された ✅ 解決策： .grepai を削除し、正しいディレクトリで init を実行します

ベストプラクティス

1. プロジェクトルートで Init： メインコードが存在する場所
2. .grepai/ を .gitignore に追加： インデックスはマシン固有です
3. 無視パターンをカスタマイズ： 生成されたコードやベンダーコードを除外します
4. Init 後に設定を確認： スタックに合わせて調整します

.gitignore 追加例

# GrepAI
.grepai/

出力形式

初期化が成功した後：

✅ 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