GraphCanon updated 3d · GitHub synced 3d
Decision brief
osgrep is an open-source tool focused on semantic search capabilities specifically designed for integration with AI agents using TypeScript.
Good fit when
- - You need advanced semantic search functionality tailored to work seamlessly with your AI agent.
- - Your project uses or plans to use TypeScript, allowing osgrep's TypeScript-based solution to integrate more smoothly.
Avoid when
- - If your search requirements can be met with simple keyword matching rather than semantic analysis, as osgrep specializes in more complex semantic searches.
- - Your AI project is not using TypeScript or where seamless integration with TypeScript-specific features of osgrep would offer no advantage.
Observed Jul 12, 2026 · Source: enrich:decision_facts
Verify the decision
Adoption
Package downloads where a registry match exists. GitHub stars (1,139) are secondary evidence.
- npm downloads (30d)
- 1,017·npm downloads API·3d
Maintenance and security
Full trust report- Maintenance
- Slowing (216d since push)
- As of 3d
- Provenance
- Not a fork · Personal account
- As of 3d
- Security (OSV)
- No lockfile
- As of 1mo
Public GitHub metadata and optional OSV scans. Signals, not a guarantee. Trust methodology.
Install
npm install osgrepHow it fits your stack(1)
Typed graph edges - alternatives, integrations, successors, and dependencies. Ranked by relationship type, not raw GitHub stars.
Relationship graph
Optional deeper exploration of typed edges and category neighbours.
Similar tools
Same-category neighbours not already linked as typed edges.
Evidence and technical details
Sourced facts, taxonomy, compatibility claims, README excerpt, and machine-readable endpoints.
Overview
Provides open-source capabilities for semantic search tailored for integrating with AI agents.
Capability facts
- CLI
- CLI entrypoint
Source: package.json:bin|scripts · Aug 22, 2026
- MCP server
- Ships MCP server
Source: package.json:@modelcontextprotocol/* · Aug 22, 2026
- Languages
- typescript, javascript
Source: github.language+package.json · Aug 22, 2026
Categories
Compatibility
Sourced claims from the README excerpt - not unsourced marketing copy.
Source: README excerpt (regex_v1, Aug 22, 2026)
npm install -g osgrepSource link
Tags
README
Quick Start
-
Install
npm install -g osgrep -
Setup (Recommended)
osgrep setupDownloads embedding models (~150MB) upfront. If you skip this, models download automatically on first use.
-
Search
cd my-repo osgrep "where do we handle authentication?"Your first search will automatically index the repository. Each repository is automatically isolated with its own index. Switching between repos "just works" — no manual configuration needed. If the background server is running (
osgrep serve), search goes through the hot daemon; otherwise it falls back to on-demand indexing. -
Trace (Call Graph)
osgrep trace "function_name"
See who calls a function (upstream dependencies) and what it calls (downstream dependencies). Perfect for impact analysis and understanding code flow.
To find the symbols in your code base:
bash osgrep symbols
In our public benchmarks, osgrep can save about 20% of your LLM tokens and deliver a 30% speedup.
License
Licensed under the Apache License, Version 2.0. See LICENSE and Apache-2.0 for details.
For agents
This page has a .md twin and JSON over the API.