Verivus Oss Sqry Skills Sqry Claude

sqry for Claude Code

Use this skill to configure Claude Code for sqry v15.0.6 MCP-backed semantic code search.

Setup

Install or upgrade sqry:

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

Index the project:

cd /path/to/your/project
sqry index .
sqry index --status --json .

Configure Claude Code:

sqry mcp setup --tool claude
sqry mcp status

This writes a Claude Code entry in .claude.json or ~/.claude.json pointing to sqry-mcp. Restart Claude Code after setup so it reloads MCP servers.

Manual config:

{
  "mcpServers": {
    "sqry": {
      "type": "stdio",
      "command": "/absolute/path/to/sqry-mcp",
      "env": {
        "SQRY_MCP_WORKSPACE_ROOT": "/path/to/your/project"
      }
    }
  }
}

For daemon-backed MCP:

sqry daemon start
sqry daemon load .
sqry-mcp --daemon

Add "args": ["--daemon"] to the Claude server entry when using daemon mode.

Skill Dependency

Also load sqry-semantic-search. It contains the shared routing rules, CLI fallback commands, ambiguity handling, output-size limits, and rebuild recovery steps.

Tool Naming

Claude Code commonly exposes sqry MCP tools with the mcp__sqry__ prefix, for example mcp__sqry__semantic_search and mcp__sqry__get_graph_stats.

Read sqry://meta/manifest first when resources are available, then use sqry://docs/capability-map and sqry://docs/tool-guide for the exact installed tool surface.

CLI Fallback

If Claude Code cannot see sqry MCP tools after setup or before restart, use:

sqry query 'kind:function AND name:authenticate' --json
sqry graph direct-callers "AuthService::authenticate" --json
sqry impact "AuthService::authenticate" --json

Recommended CLAUDE.md Addition

## Code Search

Use sqry MCP tools (`mcp__sqry__*`) for semantic code search.
Read `sqry://docs/capability-map` to find the right tool.
Use `sqry` CLI as fallback when MCP is unavailable.
Use Grep for literal text search and Glob for file finding.

Troubleshooting

• No tools visible: restart Claude Code after sqry mcp setup --tool claude.
• Empty results: run sqry index . from the project root, or sqry index --force . after an upgrade or stale graph warning.
• Stale graph or unknown plugin IDs: remove .sqry/graph, .sqry/graphs, and .sqry/analysis, then rebuild.
• Transport error on resource read: MCP server is not running or not configured.
• 404 on sqry://meta/manifest: old server version; upgrade sqry.

Source: verivus-oss/sqry-skills — distributed by TomeVault.