Project LSP

Project LSP is a Codex skill for source-code work in Git repositories. It detects supported languages and enables the matching LSP packages from this marketplace at project scope. It works with all 12 language ports and can enable multiple ports for a mixed-language repository.

After adding or refreshing the marketplace, install the selector and start a Codex thread in the project.

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

Codex can select the skill for source-code work. To run it explicitly, type $project-lsp:project-lsp and ask it to detect and activate the project's language plugins. Implicit skill selection is model-driven.

Project files

• .agents/plugins/marketplace.json references the selected packages at a pinned GitHub commit. Existing entries are preserved.
• .codex/config.toml holds project-only plugin enablement. Existing settings take precedence when they configure the same plugin.

The selector writes project configuration within the Git root. With --refresh, it asks Codex to fetch the plugins into its normal cache. The project must be trusted in Codex for the configuration to take effect. If new tools are missing in a running thread, open a fresh thread in that project. The LSP ports use the Node runtime and language-server executables already available on the Codex host's PATH.

Use from a checkout

Run the checker directly from a checkout of this marketplace for a one-time project setup. Add --check to preview the detected ports and pending changes, or repeat --file to include new source paths.

node '<marketplace checkout>/plugins/project-lsp/skills/project-lsp/scripts/project-lsp.mjs' --cwd '<project directory>' --refresh

Run the check again after the project changes languages. The checker removes its stale project enablement entries. Upgrading from the first release replaces the managed MCP settings and leaves previously copied files available for manual cleanup.