sqry

sqry is a local semantic code search tool. It parses source code into AST-backed symbol and relationship graphs so you can ask code questions that text search cannot answer reliably.

Website: https://sqry.dev

Current Capabilities

• Structural queries over symbol kind, language, visibility, names, return types, references, and relations.
• Graph analysis for callers, callees, imports, exports, call paths, cycles, unused symbols, duplicates, impact, semantic diff, and focused subgraphs.
• Edge-backed returns:<TypeName> and resolution-aware resolved_via:<kind> predicates for supported graph paths.
• Workspace-aware indexing through .sqry-workspace registries and VS Code .code-workspace sqry.workspace blocks.
• Daemon-backed shared graph loading through sqryd for editor, MCP, and repeated-agent workflows.
• MCP integration for AI assistants. Standalone sqry-mcp currently exposes 37 tools; daemon-hosted MCP exposes a 16-tool subset. Use tools/list, sqry-mcp --list-tools, or sqry://meta/manifest as the authoritative catalog.
• LSP and VS Code extension support for editor workflows.
• Natural-language translation with sqry ask, which produces a validated sqry command before execution.

When To Use sqry

Use sqry when you need structural answers:

sqry index .
sqry query "kind:function AND visibility:public AND lang:rust"
sqry query "returns:Result"
sqry graph direct-callers authenticate
sqry graph trace-path main handle_request
sqry visualize "callers:authenticate" --format mermaid

Use ripgrep for simple text search, ast-grep for syntax rewrite patterns, language linters for policy enforcement, and an IDE language server for full editor semantics. sqry stays focused on local semantic code search.

Install

Linux And macOS

curl -fsSL https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.sh | bash -s -- --component all

The shell installer downloads release assets, verifies SHA256 checksums by default, and installs:

• sqry
• sqry-mcp
• sqry-lsp
• sqryd

Supported release platforms are Linux x86_64/arm64 and macOS x86_64/arm64.

Useful options:

curl -fsSL https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.sh | \
  bash -s -- --component all --version vX.Y.Z --verify-signatures

--verify-signatures requires Cosign and verifies the oss-distribute.yml release bundle identity used by the current installer script. SHA256 verification remains the default integrity check.

Windows

Invoke-WebRequest https://raw.githubusercontent.com/verivus-oss/sqry/main/scripts/install.ps1 -OutFile install.ps1
Get-Content .\install.ps1
.\install.ps1 -Component all -VerifySignatures

The PowerShell installer downloads the Windows x86_64 release ZIP, verifies checksums by default, and installs sqry.exe, sqry-mcp.exe, sqry-lsp.exe, and sqryd.exe into the user install directory.

Use a pinned release when reproducibility matters:

.\install.ps1 -Component all -Version vX.Y.Z -VerifySignatures

Homebrew

Homebrew is the package-manager surface currently backed by the public release manifest.

brew tap verivus-oss/sqry
brew install sqry

The formula installs sqry, sqry-mcp, sqry-lsp, and sqryd for Linux x86_64/arm64 and macOS x86_64/arm64.

Scoop, Winget, AUR, Nix, and Snap are not advertised as public release assets until their release-control surfaces are complete and validated.

Build From Source

git clone https://github.com/verivus-oss/sqry.git
cd sqry
cargo install --path sqry-cli
cargo install --path sqry-mcp
cargo install --path sqry-lsp
cargo install --path sqry-daemon

Requirements:

• Rust 1.94+ with Edition 2024.
• The repository pins toolchain 1.94.1 in rust-toolchain.toml.
• A full workspace build compiles the bundled tree-sitter grammars and language plugins and can require substantial disk space.

First Index

# Build the default fast-path index.
sqry index .

# Check status without rebuilding.
sqry index --status --json .

# Force a rebuild after upgrading across graph-format or semantics changes.
sqry index --force .

Index artifacts live under .sqry/. Add .sqry/ and legacy .sqry-index artifacts to your project ignore rules unless you intentionally share them.

Plugin Selection

sqry records the plugin set that built an index so later graph-loading commands reuse the same semantics.

sqry index .                         # default fast path
sqry index --include-high-cost .     # all compiled non-default plugins
sqry index --exclude-high-cost .     # force the fast path
sqry index --enable-plugin json .    # opt into one plugin
sqry index --disable-plugin json .   # opt out of one plugin

The registry has fast plugins, high-wall-clock plugins, and optional specialty plugins. json is high-wall-clock. Optional specialty plugins include apex, abap, servicenow-xanadu-js, servicenow-xml, terraform, puppet, and pulumi when compiled with the matching Cargo features or specialty-plugins.

See Indexing for artifact cleanup, plugin tiers, and high-cost behavior.

Query Examples

# Symbol and attribute predicates.
sqry query "kind:function AND name:parse_*"
sqry query "kind:struct AND lang:rust"
sqry query "kind:function AND returns:Result"

# Relation predicates.
sqry query "callers:authenticate"
sqry query "callees:handle_request"
sqry query "imports:serde"

# Planner-backed query.
sqry plan-query "kind:function callers:main"

# Resolution-aware call filtering where populated by graph metadata.
sqry plan-query "kind:function callers:my_read resolved_via:binding_plane"

returns:<TypeName> uses graph TypeOf{Return} edges. resolved_via:<kind> accepts direct, type_match, binding_plane, virtual_dispatch, interface_dispatch, duck_typed, structural, and promiscuous_elided. framework filtering is exposed through MCP parameters today; do not rely on framework:<id> text grammar unless the current parser documentation and tests in your installed version support it.

See Advanced Analysis for graph predicates, snapshot wording, impact analysis, semantic diff, and visualization.

Natural Language

sqry ask "find public Rust functions"
sqry ask --dry-run "who calls authenticate"
sqry ask --auto-execute --threshold 0.90 "find Config structs"

sqry ask translates plain English into a validated sqry command. Without --auto-execute, it shows the command and asks for confirmation. Model downloads and unverified model loading are opt-in.

See Natural Language Queries.

Workspaces

Use a workspace when one logical project spans several repositories or folders.

sqry workspace init .
sqry workspace scan .
sqry workspace status . --json
sqry workspace clean . --dry-run

Workspace configuration can come from a .sqry-workspace registry or a VS Code .code-workspace file with a sqry.workspace block. See Workspaces.

Daemon

sqryd keeps graph state warm for repeated CLI, LSP, MCP, and editor workflows.

sqry daemon start
sqry daemon load .
sqry daemon status --json
sqry daemon rebuild . --force
sqry daemon logs --follow

See Daemon Mode.

MCP And Editors

Configure MCP clients with:

sqry mcp setup --tool claude
sqry mcp setup --tool codex
sqry mcp setup --tool gemini

Standalone sqry-mcp is the full local tool surface. sqry-mcp --daemon attaches to sqryd and exposes the daemon-hosted subset. workspace_status.source_root_id is an opaque display/correlation token, not a path. See MCP Guide and the component docs in sqry-mcp/README.md.

For the VS Code extension, see sqry-vscode/README.md and sqry-vscode/USER_GUIDE.md.

User Guides

• Quick Start
• User Guide Index
• Indexing
• Workspaces
• Daemon Mode
• MCP Guide
• Natural Language Queries
• Advanced Analysis

Project Scope

sqry is an MIT-licensed open-source project focused on one product goal: local semantic code search. It is not a hosted search platform, linter, IDE replacement, or general metrics platform.