GrepAI Watch Daemon

このスキルは、リアルタイムコードインデックスのための grepai watch コマンドとデーモン管理をカバーしています。

このスキルを使う場合

• 初期コードインデックスの開始
• リアルタイムファイルモニタリングのセットアップ
• バックグラウンドでデーモンを実行
• インデックス問題のトラブルシューティング

Watch デーモンの機能

Watch デーモンは以下を行います:

1. スキャン プロジェクト内のすべてのソースファイル
2. チャンク化 コードをセグメント (~512 tokens) に分割
3. 生成 設定されたプロバイダー経由の埋め込み
4. 保存 設定されたバックエンド内のベクトル
5. 監視 リアルタイムでファイル変更を検出
6. 更新 ファイル変更時にインデックスを更新

基本的な使い方

Watch を開始 (フォアグラウンド)

cd /your/project
grepai watch

出力:

🔍 GrepAI Watch
   Scanning files...
   Found 245 files
   Processing chunks...
   ████████████████████████████████ 100%
   Indexed 1,234 chunks
   Watching for changes...

Ctrl+C で停止します。

バックグラウンドで開始

grepai watch --background

出力:

🔍 GrepAI Watch (background)
   Daemon started with PID 12345
   Log file: ~/.grepai/daemon.log

デーモンステータスを確認

grepai watch --status

出力:

✅ GrepAI Daemon Running

   PID: 12345
   Started: 2025-01-28 10:30:00
   Project: /path/to/project

   Statistics:
   - Files indexed: 245
   - Chunks: 1,234
   - Last update: 2 minutes ago

デーモンを停止

grepai watch --stop

出力:

✅ Daemon stopped (PID 12345)

コマンドリファレンス

コマンド	説明
grepai watch	デーモンをフォアグラウンドで開始
grepai watch --background	デーモンをバックグラウンドで開始
grepai watch --status	デーモンステータスを確認
grepai watch --stop	実行中のデーモンを停止

設定

Watch 設定

# .grepai/config.yaml
watch:
  # デバウンス遅延 (ミリ秒単位)
  # 急速なファイル変更をグループ化
  debounce_ms: 500

デバウンスの説明

ファイルを保存するとき、エディタはしばしば素早く複数回書き込みます。デバウンスは変更が落ち着くのを待ちます:

値	動作
100	より反応的、より多くの再インデックス
500	バランス型 (デフォルト)
1000	反応性が低い、再インデックスが少ない

初期インデックス

インデックスされるもの

デーモンは以下のファイルをインデックスします:

• サポートされた拡張子に一致 (.go, .js, .ts, .py など)
• 無視パターンに含まれていない (node_modules, .git など)
• .gitignore を尊重

インデックス進捗

大規模なコードベースでは進捗を表示します:

Scanning files...
Found 10,245 files
Processing chunks...
████████████████░░░░░░░░░░░░░░░░ 50% (5,122/10,245)

インデックス時間の推定

コードベース	ファイル数	時間 (Ollama)	時間 (OpenAI)
小規模	100	~30秒	~10秒
中規模	1,000	~5分	~1分
大規模	10,000	~30分	~5分

リアルタイム監視

初期インデックスの後、デーモンは以下を監視します:

• ファイル作成
• ファイル変更
• ファイル削除
• ファイル名変更

ファイル変更検出

OS ネイティブのファイルウォッチングを使用:

• macOS: FSEvents
• Linux: inotify
• Windows: ReadDirectoryChangesW

再インデックスをトリガーする操作

アクション	結果
既存ファイルを保存	ファイルチャンクを再埋め込み
新しいファイルを作成	新しいチャンクをインデックス
ファイルを削除	インデックスから削除
ファイル名を変更	パスを更新、ベクトルを保持

バックグラウンドデーモン管理

システム起動時に開始

macOS (launchd)

~/Library/LaunchAgents/com.grepai.watch.plist を作成:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.grepai.watch</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/grepai</string>
        <string>watch</string>
    </array>
    <key>WorkingDirectory</key>
    <string>/path/to/your/project</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

読み込み:

launchctl load ~/Library/LaunchAgents/com.grepai.watch.plist

Linux (systemd)

~/.config/systemd/user/grepai-watch.service を作成:

[Unit]
Description=GrepAI Watch Daemon
After=network.target

[Service]
Type=simple
WorkingDirectory=/path/to/your/project
ExecStart=/usr/local/bin/grepai watch
Restart=always

[Install]
WantedBy=default.target

有効化:

systemctl --user enable grepai-watch
systemctl --user start grepai-watch

ログを確認

# バックグラウンドデーモンログ
tail -f ~/.grepai/daemon.log

# または systemd の場合
journalctl --user -u grepai-watch -f

複数プロジェクト

プロジェクトごとに 1 つのデーモン

各プロジェクト用に別々のデーモンを実行:

# ターミナル 1: プロジェクト A
cd /path/to/project-a
grepai watch --background

# ターミナル 2: プロジェクト B
cd /path/to/project-b
grepai watch --background

ワークスペースを使用

マルチプロジェクトセットアップの場合:

grepai workspace create my-workspace
grepai workspace add my-workspace /path/to/project-a
grepai workspace add my-workspace /path/to/project-b
grepai watch --workspace my-workspace

トラブルシューティング

デーモンが開始しない

❌ 問題: "別のデーモンが既に実行中です" ✅ 解決方法:

grepai watch --stop
grepai watch --background

❌ 問題: "設定が見つかりません" ✅ 解決方法: 最初に初期化:

grepai init
grepai watch

❌ 問題: "埋め込みプロバイダーの接続に失敗" ✅ 解決方法: 埋め込みプロバイダーを開始:

ollama serve  # Ollama の場合

インデックス問題

❌ 問題: ファイルがインデックスされていない ✅ 解決方法: 設定の無視パターンを確認し、ファイル拡張子がサポートされていることを確認

❌ 問題: インデックスが非常に遅い ✅ 解決方法:

• OpenAI を使用してクラウド埋め込みを高速化
• より多くの無視パターンを追加
• チャンクサイズを増加

❌ 問題: インデックスが古いようだ ✅ 解決方法: クリアして再インデックス:

rm .grepai/index.gob
grepai watch

ファイル監視の問題

❌ 問題: 変更が検出されない ✅ 解決方法:

• debounce_ms を削減
• inotify リミットを確認 (Linux):

  echo 65536 | sudo tee /proc/sys/fs/inotify/max_user_watches
  

ベストプラクティス

1. バックグラウンドで実行: 継続的な監視のため
2. モノレポにはワークスペースを使用: より良い組織化
3. 自動開始をセットアップ: launchd または systemd
4. ログを定期的に確認: エラーを監視
5. 設定変更後に再インデックス: 特に埋め込みモデル変更後

ステータス確認

定期的なヘルスチェック:

grepai status

出力:

✅ GrepAI Status

   Project: /path/to/project
   Config: .grepai/config.yaml

   Embedder: Ollama (nomic-embed-text)
   Storage: GOB (.grepai/index.gob)

   Index:
   - Files: 245
   - Chunks: 1,234
   - Size: 12.5 MB
   - Last updated: 2025-01-28 10:30:00

   Daemon: Running (PID 12345)

出力フォーマット

Watch デーモンステータス:

✅ Watch Daemon Active

   Mode: Background
   PID: 12345
   Project: /path/to/project

   Initial Index:
   - Files scanned: 245
   - Chunks created: 1,234
   - Duration: 45s

   Real-time Monitor:
   - Debounce: 500ms
   - Events processed: 23
   - Last event: 5 minutes ago

   Next steps:
   - Run 'grepai search "query"' to search
   - Run 'grepai watch --status' to check status
   - Run 'grepai watch --stop' to stop daemon