CodXER for VS Code

Official CodXER extension for Microsoft Visual Studio Code (1.104+). Connect your cxr_* API key, browse models from https://api.codxer.com/v1/models, and chat via the native Language Model Chat Provider API.

Canonical product profile: codxer.com/platforms/vscode/ · profile.json

Product modes (Standard vs Evolution)

Model ids and availability come from your CodXER account catalog (GET /v1/models). Pick the mode/model in the Copilot Chat model picker when using native LM integration.

Features

• Secure sign-in — API keys (cxr_*) stored in VS Code SecretStorage only (never in settings or workspace files)
• Native LM Chat Provider — CodXER models in the VS Code Copilot Chat model picker (vendor: codxer); agent mode requires capabilities.toolCalling on descriptors and a working tool pipeline (0.1.3+)
• Tool calling — end-to-end LM provider tool round-trip: host tools / toolMode → OpenAI tools / tool_choice → LanguageModelToolCallPart responses (streaming and non-streaming)
• Identity guard — neutralizes conflicting host Copilot identity instructions while preserving tool schemas and technical directives (0.1.4+)
• Bounded workspace context — environment facts (roots, active file, host version) injected for agent mode; explicit selection/file attach commands; no silent tree indexing (0.1.5+)
• @codxer participant — text-only chat path that calls the API directly (no VS Code agent tool orchestration; use the model picker for tools)
• IDE ↔ web pairing — scoped host session (cxs_*) via CodXER: Connect to CodXER Web and browser claim at codxer.com/ide/connect (0.2.1+)
• Shared core — @codxer/compat-core bundles environment context, identity guard, model descriptors, route broker, and HostHandshake v1 (0.2.0+)
• OpenAI-compatible API — POST /v1/chat/completions with max_tokens, optional SSE streaming
• Cancellation — in-flight requests abort when you cancel chat
• Fallback panel — text-only webview when the host does not expose vscode.lm (some forks)
• Agent telemetry — CodXER Agent output channel logs request/tool counts only (no message bodies, paths, or secrets)

Requirements

• Visual Studio Code 1.104 or newer (July 2026 stable LM Chat Provider API; agent tools verified on 1.128+)
• CodXER API key (cxr_…) from codxer.com

Quick start

1. Install from Marketplace (when published) or install the .vsix locally (Extensions: Install from VSIX…).
2. Run CodXER: Sign In (API Key) from the Command Palette.
3. Open Copilot Chat in VS Code, choose a CodXER model from the chat model picker or type @codxer in chat.
4. On first use, the extension detects VS Code Agent utility roles and configures chat.utilityModel / chat.utilitySmallModel to the canonical CodXER Low utility model. If VS Code requires interaction, run CodXER: Configure Utility Models once.
5. Optional: CodXER: Add Selection to Context before asking about code.
6. Optional: CodXER: Connect to CodXER Web to pair with codxer.com (browser claim required).

Model selection

• Agent tools (read/write/search in workspace): select a CodXER model in the Copilot Chat model picker (not @codxer). Requires toolCalling: true on the descriptor and VS Code agent mode.
• Text-only chat: @codxer participant or CodXER: Open @codxer Chat (text-only).
• Diagnostics: CodXER: Diagnose Agent Environment → Output panel shows picker blockers, bounded roots, and HostHandshake sample.

Cursor or another fork: CodXER is missing from the model picker

Cursor's Agent/Composer model dropdown is separate from the VS Code Language Model Provider API. Installing the VSIX cannot add CodXER to that dropdown, and typing only CodXER as a model name will not register it.

1. Run CodXER: Sign In (API Key) and paste the full key created at codxer.com.
2. Run CodXER: Refresh Models.
3. Run CodXER: Open Chat Panel (Fallback, text-only). This is the supported extension route when the host picker does not expose third-party models.
4. Alternatively, if the host has an OpenAI-compatible provider form, enter these exact values:
   • Provider name: CodXER
   • Base URL: https://api.codxer.com/v1
   • API key: your full cxr_… or cx_evo_… key
   • Model ID: codxer/codxer-low-2-x1.0
5. Other standard model IDs follow codxer/codxer-{low|medium|high|xhigh|max}-{2|3|4|5}-x1.0; availability depends on the account plan.

The API-key label selected on codxer.com (for example Cursor) is only an organizational label. It does not control picker registration or model access.

Commands

Settings

Privacy & security

• API keys and paired host sessions (cxs_*): VS Code SecretStorage on your machine only.
• Context attachments: kept in extension memory until cleared or VS Code restarts; sent only as part of your chat messages to CodXER API.
• Native agent mode injects bounded workspace metadata only (roots, active file path, host facts) — never full tree scan, env vars, or secrets.
• Paths outside workspace roots are not silently writable; VS Code must approve tool execution.
• Errors shown in UI are sanitized (keys redacted).
• CodXER Privacy Policy · Contact

VS Code vs Cursor (honest limits)

This extension targets the VS Code Language Model Chat Provider contract documented by Microsoft. It does not register models inside Cursor's Agent model dropdown. Cross-host templates: apps/platforms/codxer-compat/.

Troubleshooting

Canonical links

• Platform profile: https://codxer.com/platforms/vscode/
• API base: https://api.codxer.com
• Evolution spec: https://codxer.com/docs/evolution-rotation/
• Product facts registry: https://codxer.com/.well-known/codxer-product-facts.json
• Repository: https://github.com/codxer-com/codxer-vscode

Development

cd ConeXiuni-Server-host/Hetzner/apps/platforms/codxer-vscode
npm install
npm run icon:fetch   # marketplace PNG (public codxer.com asset)
npm run compile
npm run lint
npm test
npm run smoke:public
npm run validate
npm run package      # produces codxer-com.codxer-<version>.vsix

License

MIT — see LICENSE.