---
name: larger-search
description: Run graph-augmented lexical search in the current repository. Use when tasks require lexical matches plus structurally related files (calls/imports/tests/docs/config).
compatibility: Requires Python 3.11+, the local `larger` CLI package, and either `rg` or `grep` on PATH.
---

# LARGER Search Skill

This skill runs fail-first augmented search.
If index artifacts are missing, run `larger index .` first.

## Use When

- User asks to trace a bug across related files.
- User asks for dependency-graph-aware search.
- User asks where code is tested, documented, or configured.
- Plain lexical search misses likely related files.

## Do Not Use When

- User only wants literal text matches with no expansion.
- Repository context is unavailable.

## Prerequisites

- Index exists under `.larger/index`.
- Run from repository root by default, or pass `--repo`.

## Command

- Default: `larger search "<query>"`
- Optional repo override: `larger search "<query>" --repo <repo_path>`

## Expected Output

- Lexical matches first.
- Then `[Related files from dependency graph]`.

## Failure Handling

- If output says index missing, run:
  - `larger index .`
- Then rerun the same search query.