sqry-claude

sqry for Claude Code

Use this skill to configure Claude Code for sqry v33.0.1 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

By default (--scope auto) this writes a project-scoped entry into ~/.claude.json under projects["<project root>"].mcpServers.sqry, with "type": "stdio", "args": ["--no-daemon"] and SQRY_MCP_WORKSPACE_ROOT pinned to the project root. --scope global writes a global entry instead (workspace resolved from the Claude Code launch directory); --workspace-root <path> overrides the pinned root; --dry-run prints the entry without writing. Restart Claude Code after setup so it reloads MCP servers.

Manual config (same shape sqry mcp setup writes):

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

Omit SQRY_MCP_WORKSPACE_ROOT when the same entry serves several repos or git worktrees; sqry-mcp then resolves the workspace from explicit path arguments, MCP roots (Claude Code answers with the launch directory), the last-resolved workspace, then the CWD.

MCP mode: standalone vs daemon

Default: standalone sqry-mcp --no-daemon. Serves 39 tools, 6 MCP resources (sqry://meta/manifest and sqry://docs/*) and 6 prompts.

Daemon (sqry-mcp --daemon) warms the graph for long sessions but exposes only a 17-tool subset, zero MCP resources and zero prompts: agents cannot read sqry://meta/manifest or docs on the daemon path. Do not configure daemon then instruct reading MCP resources in the same workflow. With no flag at all, sqry-mcp probes for a running sqryd and connects to it when reachable, so an unflagged entry can land on the 17-tool subset silently.