Language Server Protocol (LSP) integration

{
  "lsp": {
    "language-id": {
      "disabled": false,
      "command": "path-to-language-server",
      "args": ["--stdio"]
    }
  },
  "debugLSP": false
}

{
  "lsp": {
    "go": {
      "disabled": false,
      "command": "gopls"
    }
  }
}

go install golang.org/x/tools/gopls@latest

{
  "lsp": {
    "typescript": {
      "disabled": false,
      "command": "typescript-language-server",
      "args": ["--stdio"]
    }
  }
}

npm install -g typescript-language-server typescript

{
  "lsp": {
    "javascript": {
      "disabled": false,
      "command": "typescript-language-server",
      "args": ["--stdio"]
    }
  }
}

{
  "lsp": {
    "python": {
      "disabled": false,
      "command": "pyright-langserver",
      "args": ["--stdio"]
    }
  }
}

npm install -g pyright

{
  "lsp": {
    "python": {
      "command": "pylsp"
    }
  }
}

{
  "lsp": {
    "rust": {
      "disabled": false,
      "command": "rust-analyzer"
    }
  }
}

rustup component add rust-analyzer

{
  "lsp": {
    "java": {
      "disabled": false,
      "command": "/path/to/jdtls",
      "args": ["-data", "/path/to/workspace"]
    }
  }
}

{
  "lsp": {
    "c": {
      "disabled": false,
      "command": "clangd"
    },
    "cpp": {
      "disabled": false,
      "command": "clangd"
    }
  }
}

# macOS
brew install llvm

# Ubuntu
sudo apt install clangd

AI: view src/main.ts
→ File opened in LSP if not already open
→ Diagnostics collected
→ Shown in response:

<file>
...
</file>

<file_diagnostics>
Error: src/main.ts:42:5 [typescript][2304] Cannot find name 'foo'
</file_diagnostics>

1. AI: view src/utils.ts
   → Opens file in LSP
   
2. AI: edit src/utils.ts ...
   → File already open
   → Sends didChange notification
   → New diagnostics published
   
3. AI: write src/utils.ts ...
   → Updates open file
   → Fresh diagnostics

<file_diagnostics>
Error: /path/to/file.ts:42:10 [typescript][2304] Cannot find name 'variableName'
Warn: /path/to/file.ts:56:5 [typescript][6133] 'unused' is declared but never used
Hint: /path/to/file.ts:12:8 [typescript] Parameter 'x' can be simplified
</file_diagnostics>

<project_diagnostics>
Error: /path/to/other.ts:12:1 [gopls] expected declaration, found 'IDENT'
</project_diagnostics>

<diagnostic_summary>
Current file: 1 errors, 1 warnings
Project: 1 errors, 0 warnings
</diagnostic_summary>

{
  "tool": "diagnostics",
  "parameters": {
    "file_path": "/path/to/file.ts"
  }
}

{
  "tool": "diagnostics",
  "parameters": {
    "file_path": ""
  }
}

User: Fix the type errors in src/api.ts

AI workflow:
1. diagnostics tool → identify specific errors
2. view src/api.ts → understand code context
3. edit src/api.ts → fix type issues
4. Diagnostics automatically updated
5. If errors remain, iterate

User: Check for errors before committing

AI workflow:
1. diagnostics tool (no file_path) → project-wide scan
2. Report errors by severity
3. Suggest fixes for critical issues
4. Verify no errors remain

{
  "debugLSP": true,
  "debug": true
}

opencode -d