Skip to content

wayzer107/pyright-lsp

v0.1.0Apache-2.0

Use pyright-langserver for Python code navigation and diagnostics in Codex.

Pyright LSP

Use pyright-langserver for Python code navigation and diagnostics in Codex. Supported source extensions are .py, .pyi.

Prerequisites

  • Node.js 22 or newer on the Codex host's PATH.
  • Run npm install -g pyright and make pyright-langserver available on PATH. Keep project interpreter and type-checker settings in the project's normal configuration. Language-server documentation

Use in Codex

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

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

Ask Codex to use the pyright 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 pyright-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.