@pimzino/sgrep 1.3.0

package/README.md

@@ -0,0 +1,413 @@
+# sgrep - Semantic Grep
+
+A command-line tool for semantic code search. Unlike traditional grep that matches text patterns, sgrep finds code by **meaning** - describe what functionality you're looking for, and it finds relevant code across your codebase.
+
+Powered by the [Augment SDK](https://www.augmentcode.com/).
+
+## Installation
+
+### From npm
+
+```bash
+# Install globally
+npm install -g @pimzino/sgrep
+
+# Or use with npx
+npx @pimzino/sgrep "your search query"
+```
+
+### Agent Integrations
+
+Install sgrep for your favorite AI coding agent:
+
+```bash
+# Claude Code
+sgrep install-claude-code
+
+# Cursor
+sgrep install-cursor
+
+# OpenAI Codex CLI
+sgrep install-codex
+
+# Factory Droid
+sgrep install-droid
+
+# OpenCode
+sgrep install-opencode
+```
+
+This adds the sgrep skill to your agent, allowing you to use semantic search directly in your AI coding sessions.
+
+## Prerequisites
+
+Before using sgrep, you need to:
+
+1. Install the auggie CLI:
+   ```bash
+   npm install -g @augmentcode/auggie@latest
+   ```
+
+2. Login to Augment:
+   ```bash
+   auggie login
+   ```
+
+## Usage
+
+### Semantic Search (Default Command)
+
+Search for code by describing what it does:
+
+```bash
+# Search in current directory
+sgrep "authentication middleware"
+
+# Search in specific directory
+sgrep "database connection setup" ./src
+
+# Explicit search command
+sgrep search "error handling" ./backend
+
+# Limit results
+sgrep search -m 5 "user login handling"
+```
+
+### Ask Questions
+
+Get explanations about how code works:
+
+```bash
+# Ask about architecture
+sgrep ask "How does the auth flow work?"
+
+# Ask about specific directory
+sgrep ask "What patterns are used for API endpoints?" ./api
+
+# Ask about implementation details
+sgrep ask "How is the database accessed?"
+```
+
+### Enhance Prompts
+
+Improve vague prompts with codebase context:
+
+```bash
+# Enhance a simple prompt
+sgrep enhance "fix the bug"
+
+# Enhance with specific directory context
+sgrep enhance "add authentication" ./my-project
+
+# JSON output
+sgrep enhance "refactor this" --json
+```
+
+### Watch Mode
+
+Keep the index up-to-date with live file watching:
+
+```bash
+# Watch current directory
+sgrep watch
+
+# Watch specific directory
+sgrep watch ./my-project
+
+# Write PID to file (for daemon management)
+sgrep watch --pid-file /tmp/sgrep.pid
+```
+
+Output shows real-time index updates:
+```
+[10:32:15] + added: src/newfile.ts (143 total)
+[10:32:47] ~ updated: src/utils/helper.ts (143 total)
+[10:33:02] - removed: src/oldfile.ts (142 total)
+```
+
+The `--pid-file` option is used internally by the Claude Code hooks to manage the background watch process.
+
+### Options
+
+| Option | Short | Description |
+|--------|-------|-------------|
+| `--dir <path>` | `-d` | Directory to search (default: cwd) |
+| `--max-results <n>` | `-m` | Limit number of results (search only) |
+| `--json` | `-j` | Output results as JSON |
+| `--no-color` | | Disable colored output |
+| `--debug` | | Enable verbose debug logging |
+| `--pid-file <path>` | | Write PID to file (watch command only) |
+| `--version` | `-v` | Show version |
+| `--help` | `-h` | Show help |
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `sgrep <query>` | Semantic search (default) |
+| `sgrep search <query>` | Semantic search |
+| `sgrep ask <question>` | Ask a question about the codebase |
+| `sgrep enhance <prompt>` | Enhance a prompt with codebase context |
+| `sgrep watch` | Watch for file changes and keep index updated |
+| `sgrep install-claude-code` | Install Claude Code plugin |
+| `sgrep uninstall-claude-code` | Uninstall Claude Code plugin |
+| `sgrep install-codex` | Install Codex CLI plugin |
+| `sgrep uninstall-codex` | Uninstall Codex CLI plugin |
+| `sgrep install-cursor` | Install Cursor skill |
+| `sgrep uninstall-cursor` | Uninstall Cursor skill |
+| `sgrep install-droid` | Install Factory Droid plugin |
+| `sgrep uninstall-droid` | Uninstall Factory Droid plugin |
+| `sgrep install-opencode` | Install OpenCode plugin |
+| `sgrep uninstall-opencode` | Uninstall OpenCode plugin |
+
+### Examples
+
+```bash
+# Basic semantic search
+sgrep "user authentication"
+
+# Search with path as positional argument
+sgrep "API rate limiting" ./packages/api
+
+# JSON output for piping
+sgrep "error handling" --json | jq '.results'
+
+# Debug mode for troubleshooting
+sgrep --debug "database models"
+
+# Ask a question
+sgrep ask "What testing frameworks are used?"
+
+# Enhance a vague instruction
+sgrep enhance "fix the login issue"
+
+# Watch for changes
+sgrep watch ./src
+```
+
+## Configuration
+
+sgrep supports configuration via files with cascading priority:
+
+1. CLI flags (highest priority)
+2. Environment variables
+3. Local config file (`.sgreprc.json` in cwd or parent dirs)
+4. Global config file (`~/.config/sgrep/config.json`)
+
+### Config File Format
+
+Create a `.sgreprc.json` file:
+
+```json
+{
+  "defaultDir": "./src",
+  "maxResults": 10,
+  "outputFormat": "pretty"
+}
+```
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `SGREP_DIR` | Default directory to search |
+| `SGREP_DEBUG` | Enable debug mode for CLI and hooks (`true` or `1`) |
+| `SGREP_MAX_RESULTS` | Default max results |
+| `SGREP_FORMAT` | Output format (`json` or `pretty`) |
+| `NO_COLOR` | Disable colors (standard) |
+| `SGREP_NO_COLOR` | Disable colors (sgrep-specific) |
+
+#### Hook Debug Logging
+
+When using the Claude Code integration, set `SGREP_DEBUG=1` to enable detailed logging for troubleshooting hooks:
+
+```bash
+# Enable debug logging for hooks
+set SGREP_DEBUG=1  # Windows
+export SGREP_DEBUG=1  # Linux/macOS
+```
+
+Debug logs are written to:
+- `%TEMP%\sgrep-enhance.log` - Prompt enhancement hook
+- `%TEMP%\sgrep-watch.log` - Session start hook
+- `%TEMP%\sgrep-watch-kill.log` - Session end hook
+
+## How It Works
+
+sgrep uses the Augment SDK's `DirectContext` to:
+
+1. **Index your codebase** - Builds a semantic understanding of your code
+2. **Watch for changes** - Incrementally updates the index when files change
+3. **Search by meaning** - Finds code that matches your description, not just text patterns
+4. **Answer questions** - Synthesizes explanations from relevant code sections
+5. **Enhance prompts** - Improves vague instructions with codebase context
+
+This makes it powerful for:
+- Exploring unfamiliar codebases
+- Finding implementations without knowing exact names
+- Understanding how systems work
+- Discovering related code across files
+- Improving AI prompts with relevant context
+
+## Comparison with grep/ripgrep
+
+| Feature | grep/rg | sgrep |
+|---------|---------|-------|
+| Text pattern matching | Yes | No |
+| Regex support | Yes | No |
+| Find by functionality | No | Yes |
+| Understands code semantics | No | Yes |
+| Ask questions | No | Yes |
+| Enhance prompts | No | Yes |
+| Live file watching | No | Yes |
+| Speed | Instant | ~100-500ms |
+
+**Use grep/rg when:** You know the exact text, variable name, or pattern to search for.
+
+**Use sgrep when:** You want to find code by what it does, or understand how something works.
+
+## Agent Integrations
+
+sgrep includes plugins for popular AI coding agents:
+
+### Claude Code
+
+```bash
+sgrep install-claude-code
+```
+
+Adds the `/sgrep` skill to Claude Code for semantic searches directly in your coding sessions.
+
+**Features installed:**
+
+- **Skill** (`/sgrep`) - Use semantic search directly in Claude Code conversations
+- **SessionStart Hook** - Automatically starts `sgrep watch` in the background when Claude Code starts, keeping the index warm for fast searches
+- **SessionEnd Hook** - Cleanly shuts down the background watch process when Claude Code exits
+- **UserPromptSubmit Hook** - Optionally enhances your prompts with codebase context before sending to Claude (shows a confirmation dialog on Windows)
+
+### Cursor
+
+```bash
+sgrep install-cursor
+```
+
+Adds the sgrep skill to Cursor. Use `/sgrep` or Cursor will automatically use it for semantic searches.
+
+### Codex CLI
+
+```bash
+sgrep install-codex
+```
+
+Integrates with OpenAI's Codex CLI, adding MCP server support and the sgrep skill.
+
+### Factory Droid
+
+```bash
+sgrep install-droid
+```
+
+Installs hooks and skills for Factory Droid with automatic file watching on session start.
+
+### OpenCode
+
+```bash
+sgrep install-opencode
+```
+
+Adds the sgrep tool to the OpenCode agent with MCP configuration.
+
+### Uninstalling
+
+To uninstall from any agent, use the corresponding uninstall command:
+```bash
+sgrep uninstall-claude-code
+sgrep uninstall-cursor
+sgrep uninstall-codex
+sgrep uninstall-droid
+sgrep uninstall-opencode
+```
+
+## Troubleshooting
+
+### "Authentication Error"
+
+Make sure you've logged in:
+```bash
+auggie login
+```
+
+### "Directory does not exist"
+
+Check the path you're providing:
+```bash
+# Use absolute or relative path
+sgrep "query" /absolute/path
+sgrep "query" ./relative/path
+```
+
+### Slow first search
+
+The first search indexes the codebase, which can take a moment for large projects. Subsequent searches reuse the index.
+
+### Debug mode
+
+Use `--debug` to see what's happening:
+```bash
+sgrep --debug "your query"
+```
+
+### Claude Code hooks not working
+
+1. **Check the plugin is installed:**
+   ```bash
+   # Look for sgrep in Claude Code plugins
+   cat ~/.claude/settings.json | grep -A5 "plugins"
+   ```
+
+2. **Check the cache has the latest version:**
+   ```bash
+   # Windows - clear the plugin cache and reinstall
+   Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\cache\sgrep"
+   sgrep uninstall-claude-code
+   sgrep install-claude-code
+   ```
+
+3. **Enable debug logging:**
+   ```bash
+   # Set environment variable before starting Claude Code
+   set SGREP_DEBUG=1  # Windows
+   export SGREP_DEBUG=1  # Linux/macOS
+   ```
+
+4. **Check the debug logs:**
+   - Windows: `%TEMP%\sgrep-watch.log`, `%TEMP%\sgrep-enhance.log`
+   - Linux/macOS: `/tmp/sgrep-watch.log`, `/tmp/sgrep-enhance.log`
+
+### Watch process not starting
+
+If the background watch process isn't starting on Claude Code session start:
+
+1. **Check sgrep is in PATH:**
+   ```bash
+   where sgrep  # Windows
+   which sgrep  # Linux/macOS
+   ```
+
+2. **Try running watch manually:**
+   ```bash
+   sgrep watch --debug
+   ```
+
+3. **Check for existing PID files:**
+   ```bash
+   # Windows
+   dir %TEMP%\sgrep-watch-pid-*
+
+   # Linux/macOS
+   ls /tmp/sgrep-watch-pid-*
+   ```
+
+## License
+
+MIT

package/build/.claude-plugin/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "sgrep",
+  "owner": {
+    "name": "pimzino",
+    "email": "pimzino@users.noreply.github.com"
+  },
+  "plugins": [
+    {
+      "name": "sgrep",
+      "source": "./plugins/sgrep",
+      "description": "Semantic grep - search codebases by meaning using AI powered by Augment SDK",
+      "version": "1.0.0",
+      "author": {
+        "name": "pimzino"
+      },
+      "skills": ["./skills/sgrep"]
+    }
+  ]
+}

package/build/commands/ask.d.ts

@@ -0,0 +1,11 @@
+export interface AskOptions {
+    dir?: string;
+    json?: boolean;
+    noColor?: boolean;
+    debug?: boolean;
+}
+/**
+ * Execute the ask command.
+ */
+export declare function askCommand(question: string, pathArg: string | undefined, options: AskOptions): Promise<void>;
+//# sourceMappingURL=ask.d.ts.map

package/build/commands/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CA2Df"}

package/build/commands/ask.js

@@ -0,0 +1,65 @@
+import * as path from "path";
+import * as fs from "fs";
+import { ask as askCodebase, closeContext } from "../utils/context.js";
+import { printAnswer, printError, debug, initOutput } from "../utils/output.js";
+import { loadConfig, mergeWithCliOptions } from "../utils/config.js";
+/**
+ * Execute the ask command.
+ */
+export async function askCommand(question, pathArg, options) {
+    // Load and merge config
+    const baseConfig = loadConfig();
+    const config = mergeWithCliOptions(baseConfig, options);
+    // Initialize output with final options
+    initOutput({
+        noColor: config.noColor,
+        json: config.outputFormat === "json",
+        debug: config.debug,
+    });
+    debug(`Question: ${question}`);
+    debug(`Options: ${JSON.stringify(options)}`);
+    debug(`Config: ${JSON.stringify(config)}`);
+    // Determine directory to search
+    let directory;
+    if (pathArg) {
+        directory = path.resolve(pathArg);
+    }
+    else if (config.defaultDir) {
+        directory = path.resolve(config.defaultDir);
+    }
+    else {
+        directory = process.cwd();
+    }
+    debug(`Directory: ${directory}`);
+    // Validate directory
+    if (!fs.existsSync(directory)) {
+        printError(`Directory does not exist: ${directory}`);
+        process.exit(1);
+    }
+    if (!fs.statSync(directory).isDirectory()) {
+        printError(`Path is not a directory: ${directory}`);
+        process.exit(1);
+    }
+    try {
+        const answer = await askCodebase(directory, question);
+        if (!answer || answer.trim() === "") {
+            if (config.outputFormat === "json") {
+                console.log(JSON.stringify({ type: "answer", answer: "", message: "No answer available" }, null, 2));
+            }
+            else {
+                console.log("Unable to answer the question based on the codebase.");
+            }
+            return;
+        }
+        printAnswer(answer);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        printError(errorMessage);
+        process.exit(1);
+    }
+    finally {
+        await closeContext();
+    }
+}
+//# sourceMappingURL=ask.js.map

package/build/commands/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"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"}

package/build/commands/enhance.d.ts

@@ -0,0 +1,16 @@
+export interface EnhanceOptions {
+    dir?: string;
+    json?: boolean;
+    noColor?: boolean;
+    debug?: boolean;
+}
+export interface EnhanceResult {
+    original: string;
+    enhanced: string;
+}
+/**
+ * Execute the enhance command.
+ * Takes a prompt and enhances it using codebase context.
+ */
+export declare function enhanceCommand(prompt: string, pathArg: string | undefined, options: EnhanceOptions): Promise<void>;
+//# sourceMappingURL=enhance.d.ts.map

package/build/commands/enhance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhance.d.ts","sourceRoot":"","sources":["../../src/commands/enhance.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAoGf"}

package/build/commands/enhance.js

@@ -0,0 +1,107 @@
+import * as path from "path";
+import * as fs from "fs";
+import chalk from "chalk";
+import { getContext, closeContext } from "../utils/context.js";
+import { printError, debug, initOutput } from "../utils/output.js";
+import { loadConfig, mergeWithCliOptions } from "../utils/config.js";
+import { parseEnhancedPrompt, buildEnhancementInstruction } from "../utils/prompt-parser.js";
+/**
+ * Execute the enhance command.
+ * Takes a prompt and enhances it using codebase context.
+ */
+export async function enhanceCommand(prompt, pathArg, options) {
+    // Load and merge config
+    const baseConfig = loadConfig();
+    const config = mergeWithCliOptions(baseConfig, options);
+    const useJson = config.outputFormat === "json";
+    const useColor = !config.noColor;
+    // Initialize output with final options
+    initOutput({
+        noColor: config.noColor,
+        json: useJson,
+        debug: config.debug,
+    });
+    debug(`Prompt: ${prompt}`);
+    debug(`Options: ${JSON.stringify(options)}`);
+    debug(`Config: ${JSON.stringify(config)}`);
+    // Determine directory to use for context
+    let directory;
+    if (pathArg) {
+        directory = path.resolve(pathArg);
+    }
+    else if (config.defaultDir) {
+        directory = path.resolve(config.defaultDir);
+    }
+    else {
+        directory = process.cwd();
+    }
+    debug(`Directory: ${directory}`);
+    // Validate directory
+    if (!fs.existsSync(directory)) {
+        printError(`Directory does not exist: ${directory}`);
+        process.exit(1);
+    }
+    if (!fs.statSync(directory).isDirectory()) {
+        printError(`Path is not a directory: ${directory}`);
+        process.exit(1);
+    }
+    try {
+        // Get context
+        const context = await getContext(directory);
+        // Build the enhancement instruction
+        const enhancementInstruction = buildEnhancementInstruction(prompt);
+        debug(`Enhancement instruction built`);
+        // Use searchAndAsk to enhance the prompt
+        // The original prompt is used as the search query to find relevant code
+        const response = await context.searchAndAsk(prompt, enhancementInstruction);
+        debug(`Response received (${response.length} characters)`);
+        // Parse the enhanced prompt from the response
+        const enhanced = parseEnhancedPrompt(response);
+        if (!enhanced) {
+            // If parsing failed, show the raw response for debugging
+            if (useJson) {
+                console.log(JSON.stringify({
+                    type: "enhance",
+                    original: prompt,
+                    enhanced: null,
+                    error: "Failed to parse enhanced prompt from response",
+                    rawResponse: response,
+                }, null, 2));
+            }
+            else {
+                printError("Failed to parse enhanced prompt from AI response");
+                console.log("");
+                console.log(useColor ? chalk.gray("Raw response:") : "Raw response:");
+                console.log(response);
+            }
+            process.exit(1);
+        }
+        // Output the result
+        if (useJson) {
+            const result = {
+                original: prompt,
+                enhanced: enhanced,
+            };
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            // Pretty output
+            console.log("");
+            console.log(useColor ? chalk.cyan("Original:") : "Original:");
+            console.log(useColor ? chalk.gray(prompt) : prompt);
+            console.log("");
+            console.log(useColor ? chalk.cyan("Enhanced:") : "Enhanced:");
+            console.log(enhanced);
+            console.log("");
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        printError(errorMessage);
+        process.exit(1);
+    }
+    finally {
+        await closeContext();
+    }
+}
+//# sourceMappingURL=enhance.js.map

package/build/commands/enhance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhance.js","sourceRoot":"","sources":["../../src/commands/enhance.ts"],"names":[],"mappings":"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"}

package/build/commands/search.d.ts

@@ -0,0 +1,12 @@
+export interface SearchOptions {
+    dir?: string;
+    maxResults?: number;
+    json?: boolean;
+    noColor?: boolean;
+    debug?: boolean;
+}
+/**
+ * Execute the search command.
+ */
+export declare function searchCommand(query: string, pathArg: string | undefined, options: SearchOptions): Promise<void>;
+//# sourceMappingURL=search.d.ts.map

package/build/commands/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Df"}