Rust Code Navigator

Name: rust-code-navigator
Rating: 92
Author: simorgh3196

Navigate large Rust codebases efficiently using Language Server Protocol.

Usage

code

/rust-code-navigator <symbol> [in file.rs:line]

Examples:

•/rust-code-navigator parse_config - Find definition of parse_config
•/rust-code-navigator MyStruct in src/lib.rs:42 - Navigate from specific location

LSP Operations

1. Go to Definition

Find where a symbol is defined.

code

LSP(
  operation: "goToDefinition",
  filePath: "src/main.rs",
  line: 25,
  character: 10
)

Use when:

•User asks "where is X defined?"
•User wants to understand a type/function
•Ctrl+click equivalent

2. Find References

Find all usages of a symbol.

code

LSP(
  operation: "findReferences",
  filePath: "src/lib.rs",
  line: 15,
  character: 8
)

Use when:

•User asks "who uses X?"
•Before refactoring/renaming
•Understanding impact of changes

3. Hover Information

Get type and documentation for a symbol.

code

LSP(
  operation: "hover",
  filePath: "src/main.rs",
  line: 30,
  character: 15
)

Use when:

•User asks "what type is X?"
•User wants documentation
•Quick type checking

Workflow

code

User: "Where is the Config struct defined?"
    │
    ▼
[1] Search for "Config" in workspace
    LSP(operation: "workspaceSymbol", ...)
    │
    ▼
[2] If multiple results, ask user to clarify
    │
    ▼
[3] Go to definition
    LSP(operation: "goToDefinition", ...)
    │
    ▼
[4] Show file path and context
    Read surrounding code for context

Output Format

Definition Found

code

## Config (struct)

**Defined in:** `src/config.rs:15`

```rust
#[derive(Debug, Clone)]
pub struct Config {
    pub name: String,
    pub port: u16,
    pub debug: bool,
}
```

**Documentation:** Configuration for the application server.

References Found

code

## References to `Config` (5 found)

| Location | Context |
|----------|---------|
| src/main.rs:10 | `let config = Config::load()?;` |
| src/server.rs:25 | `fn new(config: Config) -> Self` |
| src/server.rs:42 | `self.config.port` |
| src/tests.rs:15 | `Config::default()` |
| src/cli.rs:8 | `config: Option<Config>` |

Common Patterns

User Says	LSP Operation
"Where is X defined?"	goToDefinition
"Who uses X?"	findReferences
"What type is X?"	hover
"Find all structs"	workspaceSymbol
"What's in this file?"	documentSymbol

Error Handling

Error	Cause	Solution
"No LSP server"	rust-analyzer not running	Suggest: `rustup component add rust-analyzer`
"Symbol not found"	Typo or not in scope	Search with workspaceSymbol first
"Multiple definitions"	Generics or macros	Show all and let user choose

Related Skills

When	See
Call relationships	rust-call-graph
Project structure	rust-symbol-analyzer
Trait implementations	rust-trait-explorer
Safe refactoring	rust-refactor-helper