sqry for OpenAI Codex

This skill configures the Codex CLI agent to use sqry's MCP server for AST-based semantic code search across 37 languages.

Setup

1. Install sqry

bash

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

# Fallback: build from source
cargo install sqry-cli
cargo install sqry-mcp

# Alternative package manager
brew install verivus-oss/sqry/sqry

2. Index your project

bash

cd /path/to/your/project
sqry index .

3. Configure MCP server

Recommended:

bash

sqry mcp setup --tool codex
sqry mcp status

This writes a global entry to

~/.codex/config.toml

toml

[mcp_servers.sqry]
command = "/absolute/path/to/sqry-mcp"

Codex uses global MCP config and CWD-based workspace discovery. Start Codex from the project directory you want to analyze.

4. Verify

After restarting Codex, test with:

"Use sqry to show graph stats for this project"

Skill Dependency

This skill covers Codex CLI setup and integration patterns. Also load the
sqry-semantic-search
skill for tool selection guidance, query syntax, and disambiguation strategies.

sqry-semantic-search uses tiered discovery to save tokens: it loads a compact Quick Tool Selection guide first. If you need full parameter details, load

sqry-semantic-search/references/tool-reference.md

. For advanced workflows (security audit, pre-change analysis), load

sqry-semantic-search/references/workflows.md

. Only load what you need.

Quick Tool Selection

I know the symbol name and want to...

See its definition →
```
mcp__sqry__get_definition
```

See who calls it →

mcp__sqry__direct_callers

(depth=1) or

mcp__sqry__relation_query

(multi-depth)

See what it calls →
```
mcp__sqry__direct_callees
```
See what breaks if I change it →
```
mcp__sqry__dependency_impact
```
Understand it with context →
```
mcp__sqry__explain_code
```

I want to search for symbols...

By name substring →
```
mcp__sqry__pattern_search
```
By kind/visibility/language →
```
mcp__sqry__semantic_search
```
With RAG-optimized grouping →
```
mcp__sqry__hierarchical_search
```

I want to analyze the codebase...

Circular dependencies →
```
mcp__sqry__find_cycles
```
Dead code →
```
mcp__sqry__find_unused
```
Change impact →
```
mcp__sqry__dependency_impact
```
Trace call path A→B →
```
mcp__sqry__trace_path
```

Handling Ambiguous Symbols

When using

mcp__sqry__direct_callers

mcp__sqry__direct_callees

, or

mcp__sqry__call_hierarchy

with common names (

handle

new

init

process

run

), the tool may fail or return wrong results.

Always disambiguate by providing

file_path

json

{
  "symbol": "handle",
  "file_path": "src/api/router.rs"
}

Or use a qualified name:

"symbol": "UserService::authenticate"

If relation tools fail, fall back to

mcp__sqry__get_references

with a

path

filter to scope results.

Tool Naming in Codex

Codex uses the

mcp__sqry__

prefix for sqry MCP tools:

mcp__sqry__semantic_search
mcp__sqry__relation_query
mcp__sqry__dependency_impact
mcp__sqry__explain_code
mcp__sqry__trace_path
...

Recommended AGENTS.md Addition

Add this to your project's

AGENTS.md

CODEX.md

markdown

## Code Search

Use sqry MCP tools for semantic code search:
- `mcp__sqry__semantic_search` - Find symbols by structure
- `mcp__sqry__relation_query` - Find callers, callees, imports
- `mcp__sqry__dependency_impact` - Analyze change impact
- `mcp__sqry__explain_code` - Understand a symbol with context

Use `rg` for literal text search. Use sqry for everything structural.

Workflow

Use
```
mcp__sqry__semantic_search
```
or
```
mcp__sqry__pattern_search
```
to discover relevant code before reading files.
Use
```
mcp__sqry__dependency_impact
```
before modifying shared symbols.
Run the narrowest relevant tests first, then broader checks for shared paths.
Report files changed, behavior impact, and tests run in handoff.

Common Codex Patterns

Find and understand a symbol

1. mcp__sqry__semantic_search   query: "kind:function name:process_order"
2. mcp__sqry__explain_code      file_path: "src/orders.rs", symbol_name: "process_order"
3. mcp__sqry__direct_callers    symbol: "process_order"

Pre-change impact analysis

1. mcp__sqry__dependency_impact  symbol: "shared_utility", max_depth: 3
2. mcp__sqry__find_cycles        (check for circular deps)
3. Make changes
4. mcp__sqry__semantic_diff      base: {ref: "main"}, target: {ref: "HEAD"}

Recent Features (since v6.0)

Plugin cost tiering

Plugins classified as
```
Fast
```
(default) or
```
HighWallClock
```
High-cost plugins (JSON, ServiceNow XML) excluded from default index

CLI:

--include-high-cost

--exclude-high-cost

--enable-plugin ID

--disable-plugin ID

Env:
```
SQRY_INCLUDE_HIGH_COST=1
```

Time-expensive MCP operations

```
rebuild_index
```
: 10min timeout, full graph rebuild -- only when index stale
```
semantic_diff
```
: creates git worktrees + indexes -- scope with file/kind filters
```
find_cycles
```
,
```
complexity_metrics
```
: can timeout on large graphs -- scope to files
```
find_duplicates
```
: quadratic scaling -- filter by file/language/kind
```
call_hierarchy
```
depth>2,
```
dependency_impact
```
depth>3: exponential growth

Macro boundary analysis (Rust)

CLI:

sqry cache expand

--enable-macro-expansion

--cfg

--cfg-filter

--include-generated

--macro-boundaries

MCP:
```
mcp__sqry__expand_cache_status
```
tool, macro metadata in search/definition results

JVM classpath analysis

CLI:

--classpath

--classpath-depth

--classpath-file

MCP:
```
include_classpath
```
parameter on search tools,
```
provenance
```
field in results

Security defaults

MCP redaction preset now
```
"minimal"
```
by default (was
```
"none"
```
)
Override:
```
SQRY_REDACTION_PRESET=none
```
Index timeout: 600s, query timeout: 60s

Other

37 language plugins (added JSON, ServiceNow XML)
Snapshot format V7 -- rebuild index on major version upgrade
Multi-root VS Code workspace support

Troubleshooting

No tools visible: Restart Codex after running
```
sqry mcp setup --tool codex
```
Empty results: Run
```
sqry index .
```
to build the index
Stale results: Run
```
sqry index --force .
```
to force rebuild
Snapshot version mismatch: Run
```
rm -rf .sqry/graph && sqry index .
```
after major upgrades
Missing JSON/ServiceNow symbols: Rebuild with
```
sqry index --include-high-cost
```
Check health: Call
```
mcp__sqry__get_index_status
```

sqry-codex

NPX Install

Tags

SKILL.md Content

sqry for OpenAI Codex

Setup

1. Install sqry

2. Index your project

3. Configure MCP server

4. Verify

Skill Dependency

Quick Tool Selection

Handling Ambiguous Symbols

Tool Naming in Codex

Recommended AGENTS.md Addition

Workflow

Common Codex Patterns

Find and understand a symbol

Pre-change impact analysis

Recent Features (since v6.0)

Plugin cost tiering

Time-expensive MCP operations

Macro boundary analysis (Rust)

JVM classpath analysis

Security defaults

Other

Troubleshooting