Verify location exists

------------- | ---------------- | ----------------------------------------------- | | Find Definition | grep, read | definition | | Find Usages | grep -r | reference | | Understand File | read | outline | | View Docs/Types | read | doc | | Refactor | sed | See Refactoring Guide |

Commands

All commands support -h or --help.

Locating Symbols

Most commands use a unified locating syntax via the --scope and --find options.

Arguments: <file_path>

Options:

• --scope: Narrow search to a symbol body or line range.
• --find: Text pattern to find within the scope.

Scope Formats:

• <line>: Single line number (e.g., 42).
• <start>,<end>: Line range (e.g., 10,20). Use 0 for end to mean till EOF (e.g., 10,0).
• <symbol_path>: Symbol path with dots (e.g., MyClass.my_method).

Find Pattern (--find):

The --find option narrows the target to a text pattern within the selected scope:

• The scope is determined by --scope (line/range/symbol). If no --scope is given, the entire file is the scope.
• Pattern matching is whitespace-insensitive: differences in spaces, tabs, and newlines are ignored.
• You MAY include the cursor marker <|> inside the pattern to specify the exact position of interest within the match (for example, on a variable name, keyword, or operator).
• If --find is omitted, the command uses the start of the scope (or a tool-specific default) as the navigation target.

Cursor Marker (<|>):

The <|> marker indicates the exact position for symbol resolution. It represents the character immediately to its right. Use it within the find pattern to point to a specific element (e.g., user.<|>name to target the name property).