models.ageneral.ai through a virtual key for your account or project scope.
Before you begin
Third-party models in Chat follow Microsoft’s guidance for Copilot Chat and language model APIs.
| Requirement | Notes |
|---|---|
| VS Code | >= 1.94.0 |
| Network | Access to ageneral.ai and models.ageneral.ai |
| Desktop sign-in | OAuth uses a system browser and a vscode:// callback |
Quickstart
Install the extension
If the extension is distributed as a When the extension is published to the Marketplace, install it from Extensions like any other extension.
.vsix file, install it with Extensions → ⋯ → Install from VSIX…, or from a terminal:Sign in to Ageneral
Run Ageneral: Sign In from the Command Palette or from Accounts. Complete sign-in in the browser; your session is stored securely in VS Code.
Sign-in and environments
OAuth expects a normal desktop: a system browser opens and returns to VS Code viavscode://. That flow is unreliable in headless or server-only dev containers without a desktop browser. For sign-in, use VS Code on a machine where the redirect works, often the host OS.
Chat participant
| Participant ID | Name | Role |
|---|---|---|
ageneral.coder | Ageneral Coder | Handles prompts and bridges to local OpenCode with your selected Ageneral model. |
vscode.chat.createChatParticipant, the same API family as GitHub Copilot Chat.
Virtual keys and billing
Inference and usage follow the same rules as direct API use. See Authentication for virtual keys and node identity, and Usage and billing for credits and errors.Develop or package the extension
To build from source, produce a.vsix, or publish to the Marketplace, use the vscode/ package in the Ageneral repository: clone the repo, run npm install, then npm run compile for development or npm run package for production, and follow vscode/README.md for F5 debugging, vsce, and release steps.
Related
Authentication
Sessions, virtual keys, and how the extension fits in.
Quickstart
Orient yourself and reach your first Models API call.
Models
Base URL, auth, and OpenAPI endpoints.
Troubleshooting
Common errors and what to try next.