# Verivus Oss Sqry Skills Sqry Claude

> sqry for Claude Code

- Skill: `tomevault-io/verivus-oss-sqry-skills-sqry-claude` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/verivus-oss-sqry-skills-sqry-claude`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/verivus-oss-sqry-skills-sqry-claude/raw
- Safety review: WARNING (external: skill-scanner WARNING, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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:

```bash
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:

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

Configure Claude Code:

```bash
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:

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

For daemon-backed MCP:

```bash
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:

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

## Recommended CLAUDE.md Addition

```markdown
## 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](https://github.com/verivus-oss/sqry-skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->