osgrep

Search local files semantically with natural language queries and return structured results.

121|16|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/pr-pm/prpm --skill osgrep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: osgrep
Source: https://github.com/pr-pm/prpm/tree/main/.openskills/osgrep-skill
Command: npx skills add https://github.com/pr-pm/prpm --skill osgrep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the frustration of searching for code using exact text matches when you only understand the conceptual behavior or functionality you're looking for.

Core Features & Use Cases

  • Semantic Code Search: Find code using natural language queries about functionality and behavior.
  • Architecture Discovery: Map distributed patterns across multiple files and directories.
  • Use Case: When a developer asks "where is authentication validated" or "how are plugins loaded", this Skill locates the relevant code snippets across the entire codebase without requiring exact function names.

Quick Start

Use osgrep to find where authentication logic is implemented in the current codebase.

Frequently Asked Questions about osgrep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for code by concept instead of exact keywords?

Semantic search lets you find code using natural language descriptions of functionality rather than exact text matches. osgrep performs semantic code search on local files, letting you query by behavior—such as 'where is authentication validated'—and returns matching code snippets with paths, line numbers, and relevance scores.

Can I use semantic search to map code patterns across a large codebase?

Yes. Semantic search is designed for architecture discovery, helping you locate distributed patterns across multiple files and directories. You can scope searches to specific directories for targeted investigations, making it effective for understanding how patterns like plugin loading or authentication span your codebase.

What do I need to set up before using semantic code search?

osgrep relies on a background live-indexing server to perform semantic search. You invoke queries with the --json flag to return structured results. The Skill works on local files without external dependencies, returning path, line, score, and content for each match.

How does semantic search differ from grep or keyword-based code search?

Traditional grep matches exact text; semantic search understands conceptual meaning and behavior. osgrep finds code by what it does, not just the words in it, so 'how are plugins loaded' returns relevant code even if exact function names vary across your codebase.

Can semantic code search help when I don't know the exact function or file names?

Exactly. Semantic search is built for discovery when you understand only the concept or functionality. Describe the behavior you're investigating—validation logic, error handling, configuration patterns—and osgrep returns matching code across your entire codebase without requiring specific identifiers.