Skip to content

wayzer107/gopls-lsp

v0.1.0Apache-2.0

Use gopls for Go code navigation and diagnostics in Codex.

GitHub

Go LSP

Use gopls for Go code navigation and diagnostics in Codex. Supported source extensions are .go.

Prerequisites

  • Node.js 22 or newer on the Codex host's PATH.
  • Run go install golang.org/x/tools/gopls@latest and make the Go binary directory available on PATH. Select the module or Go workspace root. Language-server documentation

Use in Codex

After adding the marketplace, install this plugin and start a new Codex conversation.

codex plugin add 'gopls-lsp@codex-plugin-ports'

Ask Codex to use the gopls language-server tools for your project. Call lsp_start with the absolute project root and poll lsp_status if initialization is pending. Queries use saved files and zero-based UTF-16 positions. The available features and indexing behavior depend on the native server.

Open trusted workspaces. A native language server can run build or project tools while indexing. Stop the workspace with lsp_stop when you finish or before starting another workspace.

Upstream and changes

Adapted from Anthropic's gopls-lsp under the Apache License 2.0. This port keeps the upstream file mappings and uses a local MCP bridge to start the language server and query it from Codex.