OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add yoanbernabeu/grepai-skills --skill grepai-watch-daemon
Configure and manage the GrepAI watch daemon. Use this skill for real-time code indexing and file monitoring.
npx skills add yoanbernabeu/grepai-skills --skill grepai-watch-daemon
This skill covers the grepai watch command and daemon management for real-time code indexing.
The watch daemon:
Output:
Press Ctrl+C to stop.
Output:
Output:
Output:
| Command | Description |
|---|---|
grepai watch | Start daemon in foreground |
grepai watch --background | Start daemon in background |
grepai watch --status | Check daemon status |
grepai watch --stop | Stop running daemon |
When you save a file, editors often write multiple times quickly. Debouncing waits for changes to settle:
| Value | Behavior |
|---|---|
100 | More responsive, more reindexing |
500 | Balanced (default) |
1000 | Less responsive, fewer reindexing |
The daemon indexes files:
.gitignoreLarge codebases show progress:
| Codebase | Files | Time (Ollama) | Time (OpenAI) |
|---|---|---|---|
| Small | 100 | ~30s | ~10s |
| Medium | 1,000 | ~5min | ~1min |
| Large | 10,000 | ~30min | ~5min |
After initial indexing, the daemon watches for:
Uses OS-native file watching:
| Action | Result |
|---|---|
| Save existing file | Re-embed file chunks |
| Create new file | Index new chunks |
| Delete file | Remove from index |
| Rename file | Update path, keep vectors |
Create ~/Library/LaunchAgents/com.grepai.watch.plist:
Load:
Create ~/.config/systemd/user/grepai-watch.service:
Enable:
Run separate daemons for each project:
For multi-project setups:
❌ Problem: "Another daemon is already running" ✅ Solution:
❌ Problem: "Config not found" ✅ Solution: Initialize first:
❌ Problem: "Embedder connection failed" ✅ Solution: Start your embedding provider:
❌ Problem: Files not being indexed ✅ Solution: Check ignore patterns in config, ensure file extension is supported
❌ Problem: Indexing very slow ✅ Solutions:
❌ Problem: Index seems outdated ✅ Solution: Clear and reindex:
❌ Problem: Changes not detected ✅ Solutions:
Regular health check:
Output:
Watch daemon status: