# sqry

> Semantic code search engine. Parses source code into ASTs, builds a graph of symbols and relationships, answers structural queries exactly. AST-based, not embeddings. 37 language plugins, 38 MCP tools, LSP server, persistent daemon. Local-only, zero telemetry, MIT licensed.

## About
- **Type**: SoftwareApplication
- **Category**: Developer Tools / Code Search
- **Language**: English
- **Audience**: Software engineers, security auditors, AI agent builders
- **Pricing**: Free (MIT)
- **Version**: latest published release
- **Last Updated**: 2026-07

## Links
- [Homepage](https://sqry.dev/): Product overview, benchmarks, and positioning.
- [Docs](https://sqry.dev/docs/): Product and reference documentation.
- [Install guide](https://sqry.dev/install.md): Agent-readable setup and MCP-wiring instructions.
- [Agent guide](https://sqry.dev/agents.md): Long-form agent-facing guide (install, MCP modes, tools, query syntax, workflows, troubleshooting).
- [Tool index](https://sqry.dev/tools.md): The 38 MCP tools grouped by family, plus the 16-tool daemon subset.
- [Full export](https://sqry.dev/llms-full.txt): Full documentation export for RAG systems.
- [Discovery matrix](https://sqry.dev/DISCOVERY.md): Route matrix for machine-readable files and headers.
- [Sitemap](https://sqry.dev/sitemap.md): Human-readable index of public resources.
- [Agent metadata](https://sqry.dev/.well-known/agent.json): Structured metadata for MCP clients and retrieval agents.
- [MCP server card](https://sqry.dev/.well-known/mcp/server-card.json): MCP package, transport, and tool metadata.
- [API catalog](https://sqry.dev/.well-known/api-catalog): Machine-readable service catalog (RFC 9727 linkset).
- [Integrations](https://sqry.dev/.well-known/integrations.json): Owner-declared MCP surfaces and auth facts.
- [Repository](https://github.com/verivus-oss/sqry): Source code, issues, releases.

MCP Registry name: `io.github.verivus-oss/sqry`

## Positioning

sqry searches code by structure using tree-sitter AST parsing, not text
matching or embeddings. It builds a graph of symbols and relations, then
answers structural queries exactly (callers, callees, implementations,
imports) with zero false positives. Use ripgrep for literal text search and
ast-grep for syntax rewrites; sqry answers the structural questions those
cannot.

Agent-friendly representations: send `Accept: text/markdown` to any docs or
site page for clean markdown, or `Accept: application/json` for structured
JSON. `https://sqry.dev/llms-full.txt` is the full documentation export.

## Install

macOS/Linux: curl -fsSL https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.sh | bash -s -- --component all
Windows:     irm https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.ps1 | iex
Homebrew:    brew tap verivus-oss/sqry && brew install sqry
crates.io:   cargo install sqry-cli

Installs four binaries: sqry, sqry-mcp, sqry-lsp, sqryd. No npm path.

## Quick Start

sqry index .                              # index current directory
sqry query "kind:function"                # all functions
sqry query "callers:authenticate"         # exact callers of authenticate()
sqry query "impl:Serialize"               # all Serialize implementations
sqry query "kind:function AND async:true AND lang:rust"
sqry plan-query "kind:function has:caller" # planner predicate-chain syntax
sqry shell .                              # interactive REPL

## MCP Integration (Claude, Codex, Gemini, Cursor, Windsurf)

sqry mcp setup --tool claude              # auto-configure an AI assistant
sqry mcp status                           # verify configuration

Standalone sqry-mcp serves 38 tools. Daemon-hosted (sqry-mcp --daemon) serves
a 16-tool subset from a warm graph. Key MCP tools: semantic_search,
relation_query, direct_callers, direct_callees, call_hierarchy, trace_path,
find_unused, find_duplicates, find_cycles, dependency_impact, semantic_diff,
structural_similar, cross_language_edges, context_propagation, rules_run,
sqry_query.

## Query Field Reference

kind:function|class|struct|method|interface|trait|enum|module|constant
name:symbol_name    name~=/regex/
lang:rust|python|typescript|javascript|go|java|...
path:src/**/*.rs    path~=/regex/
visibility:public|private
async:true|false
returns:Result
impl:TraitName
callers:function_name
callees:function_name
imports:module_name
parent:ContainerName

Operators: AND OR NOT ( )  Comparators: : ~= > < >= <=
C indirect-call precision: address_taken: resolved_via: callsite_promiscuous:

## Documentation

- Docs home: https://sqry.dev/docs/
- Quick Start: https://sqry.dev/docs/quick-start/
- Installation: https://sqry.dev/docs/installation/
- Query Syntax: https://sqry.dev/docs/query-syntax/
- Field Reference: https://sqry.dev/docs/query-reference/
- Examples: https://sqry.dev/docs/examples/
- Context Propagation: https://sqry.dev/docs/context-propagation/
- MCP Setup: https://sqry.dev/docs/mcp/
- MCP Tools (38): https://sqry.dev/docs/mcp/tools/
- Daemon (sqryd): https://sqry.dev/docs/daemon/
- LSP Setup: https://sqry.dev/docs/lsp/
- Language Support (37): https://sqry.dev/docs/languages/
- Performance: https://sqry.dev/docs/performance/
- Security: https://sqry.dev/docs/security/

## Source

GitHub: https://github.com/verivus-oss/sqry
Made by Verivus Pty Ltd, https://verivus.com