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)

Mode	What it is
CodXER Standard	Multi-model synthesis for chat and the OpenAI-compatible API. May fuse multiple frontier models into one answer per request.
CodXER Evolution	Deterministic pinned-core Robin rotation: user-selected fixed AI per core; one fixed AI answers each accepted turn in strict order with shared committed conversation context. Spec: Evolution rotation.

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

Install from Marketplace (when published) or install the .vsix locally (Extensions: Install from VSIX…).
Run CodXER: Sign In (API Key) from the Command Palette.
Open Copilot Chat in VS Code, choose a CodXER model from the chat model picker or type @codxer in chat.
Optional: CodXER: Add Selection to Context before asking about code.
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.

Commands

Command	Description
`CodXER: Sign In (API Key)`	Store API key in SecretStorage
`CodXER: Sign Out`	Remove stored key
`CodXER: Manage Account & Models`	Quick actions menu
`CodXER: Refresh Models`	Reload `/v1/models` catalog
`CodXER: Add Selection to Context`	Attach editor selection (explicit)
`CodXER: Add Active File to Context`	Attach open file (explicit)
`CodXER: Clear Attached Context`	Clear attachments
`CodXER: Open Chat Panel (Fallback, text-only)`	Webview chat when LM API unavailable
`CodXER: Open @codxer Chat (text-only)`	Focus Copilot Chat for `@codxer` participant
`CodXER: Diagnose Agent Environment`	Bounded workspace environment + picker diagnostics
`CodXER: Connect to CodXER Web`	Start IDE↔web pairing (browser claim)
`CodXER: Disconnect CodXER Web`	Clear paired host session
`CodXER: Web Connection Status`	Show pairing state

Settings

Setting	Default	Description
`codxer.apiBaseUrl`	`https://api.codxer.com`	API base URL
`codxer.defaultMaxTokens`	`4096`	`max_tokens` for completions (API required)
`codxer.enableStreaming`	`true`	SSE streaming when supported
`codxer.preferredModelId`	`""`	Optional default model id
`codxer.requestTimeoutMs`	`120000`	HTTP timeout

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)

Surface	CodXER integration
Microsoft VS Code Copilot Chat (1.104+, agent tools on 1.128+)	Native `LanguageModelChatProvider` + `@codxer` text participant + picker diagnosis
Cursor Agent / Composer model picker	Not the same API — Cursor routes agents through its own stack. Install the VSIX for CodXER commands/settings; use CodXER: Open Chat Panel (Fallback) or direct API if native LM models do not appear in Cursor
Windsurf and other forks	Verify `vscode.lm.registerLanguageModelChatProvider`; fallback webview when unavailable

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

Symptom	What to try
CodXER models missing from picker	Reload window; CodXER: Refresh Models; run Diagnose Agent Environment — check `toolCalling=false` blockers
Agent mode picks CodXER but no tools	Use model picker (not `@codxer`); ensure VS Code 1.128+; verify model supports tools in catalog
Identity answers mention Copilot	Fixed in 0.1.4+ — update extension; reload window
Writes outside workspace silently fail	Expected — approve host tool prompts or use paths under listed workspace roots
`vscode.lm` unavailable	Use CodXER: Open Chat Panel (Fallback)
Pairing stuck	Complete browser claim at codxer.com/ide/connect; check Web Connection Status

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.