osgrep

Search codebases semantically using natural language queries with local embeddings.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/zach-source/claude-plugins --skill osgrep-zach-source
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: osgrep
Source: https://github.com/zach-source/claude-plugins/tree/main/plugins/devtools/skills/osgrep
Command: npx skills add https://github.com/zach-source/claude-plugins --skill osgrep-zach-source

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill replaces traditional regex-based code searching with natural language queries, making it easier to find code by concept rather than exact string matches.

Core Features & Use Cases

  • Semantic Searching: Understands code concepts to find relevant code snippets.
  • Live Indexing: Automatically keeps the search index up-to-date.
  • Local & Private: Uses local embeddings, ensuring no remote API calls.
  • Use Case: When exploring a new codebase, you can ask "Where do we handle user authentication?" and get relevant code locations without knowing specific function names or keywords.

Quick Start

Use osgrep to find code related to "user authentication tokens".

Frequently Asked Questions about osgrep

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

FAQPage Schema
How do I search a codebase using natural language instead of regex?

Semantic code search allows you to query a codebase using natural language to find relevant snippets by concept. It leverages local embeddings to locate implementations without requiring exact string matches or complex regex patterns.

Can I explore a new codebase without knowing exact function names?

Yes, codebase exploration with natural language queries enables you to find code by concept. You can ask questions like where user authentication is handled and retrieve relevant code locations without prior knowledge of specific function names.

Does semantic code search send my source code to remote APIs?

No, this semantic code search uses local embeddings via transformers.js, ensuring no remote API calls are made. This keeps your codebase exploration completely private and secure while maintaining fast search speeds.

How does local indexing handle multiple repositories?

The system uses auto-isolated indexes per repository, ensuring searches are scoped correctly to the active project. It also features live indexing to automatically keep the search index updated as your codebase changes.

What's the best way to find implementations by concept in a large codebase?

Using natural language queries for semantic code search is the best way to find implementations by concept. It relies on local embeddings and includes adaptive performance throttling to maintain responsive search speeds across large codebases.

Do I need an internet connection for natural language code search?

No, an internet connection is not required because the semantic search runs entirely on local embeddings. This offline capability guarantees privacy and allows uninterrupted codebase exploration in restricted environments.