Clangd Setup

2. Generate compile_commands.json

clangd requires a compilation database to understand the codebase.

1. Identify Build Directory: Check for common build directories like out/x64.debug, out/x64.release.
2. Check for Existing File: Check if compile_commands.json already exists in the identified build directory or at the project root.
3. Generate if Missing: If it doesn't exist, you MUST attempt to generate it.
   • Method: Run gn gen <build_dir> --export-compile-commands.
     • Example: gn gen out/x64.debug --export-compile-commands
   • Ask the user before running the command to ensure it targets the correct build directory they are working with.

3. Verify Configuration

1. Once compile_commands.json is generated, verify that clangd-mcp tools (like find_symbol, get_definition) return meaningful results for a known symbol in the codebase.

Troubleshooting

• If clangd cannot find headers, ensure compile_commands.json is at the root or linked correctly, and that the build has been run at least once to generate all necessary headers (like Torque generated files).