Overview
The Ageneral Coder extension adds:- Ageneral Models in the built-in Chat model picker.
- Ageneral Coder as a coding agent in the dedicated Chat pane.
- Invocation via
@ageneral-coderwhen an Ageneral model is selected in built-in Chat.
Contents
Requirements
| Requirement | Notes |
|---|---|
| VS Code | 1.94.0 or newer |
| Network | Reach ageneral.ai and models.ageneral.ai; local port for the helper process |
| Sign-in | Desktop VS Code recommended so vscode:// OAuth returns succeed |
Install
From Marketplace
- Open Extensions in VS Code.
- Search for Ageneral and install Ageneral Coder, or open Ageneral.ageneralcoder.
From VSIX
@vscode/vsce package writes {name}-{version}.vsix from package.json; name is ageneralcoder.)
Or use Extensions → ⋯ → Install from VSIX….
Uninstall:
Sign in and start
- Open Ageneral Coder in the activity bar. The sign-in view remains until the account links.
- Run Ageneral: Sign In from the Command Palette or the chat menu; finish OAuth in the browser.
- When sign-in completes, the Chat pane is ready and Ageneral Models appear in built-in Chat.
- Start a thread, or right-click a file and choose Add File to Ageneral Coder chat to attach context first.
Features
Chat pane
The Chat view lists conversations, starts threads, and accepts attachments. Replies may include formatted text and diagrams when the model returns them.- Back and New Chat switch between the thread list and an active thread.
- Files touched summarizes edits with add and remove counts.
- Slash commands begin with
/; pick one from the list to run in context. - Attachments appear as chips; remove them before send if needed.
- Click a prior user message to edit it; the thread restarts from that turn.
- A progress indicator runs while the assistant works; it pauses when a tool needs approval.
- Permissions for edits or reads outside the workspace respect settings.
- The thread list sorts by recent activity; delete a row to remove a thread.
Built-in Chat and @ageneral-coder
Select an Ageneral model in built-in Chat, then mention @ageneral-coder to call the same agent as the sidebar pane.
Context menus
| Location | Action |
|---|---|
| Explorer | Add File to Ageneral Coder chat |
| Explorer | Add File to new Ageneral Coder chat |
| Editor title bar / editor | Same actions |
Commands
Filter the Command Palette with Ageneral for sign-in, billing scope, model visibility, and attach-to-chat commands.Model visibility
Ageneral: Coder: Model Visibility toggles models in the sidebar picker. Values persist in extension storage, notsettings.json.
Settings
| Setting | Behavior |
|---|---|
| Ageneral: Coder: Ask for permissions | When enabled, prompts before tools run or touch files outside the workspace |
| Ageneral: Chat pane: Show message timestamps | Reserved |
| Ageneral: Output: Verbose models | Extra provider detail in Output → Ageneral |
ageneral. in Settings JSON for advanced edits.
Troubleshooting
Logs — View → Output → Ageneral. Inspect when commands fail or output mismatches expectations. OAuth in remote or headless setups — OAuth expects a local browser andvscode:// returns. Complete sign-in from desktop VS Code when remote workflows block that path.
Empty model list — Finish sign-in; verify network. The extension may fall back to an alternate catalog if the primary list is unavailable.
Missing model in sidebar — Open Ageneral: Coder: Model Visibility and enable it.
Stuck permission prompt — Choose Allow or Deny, or disable Ageneral: Coder: Ask for permissions for silent tool runs.
Next steps
Authentication
Sign-in, virtual keys, and credential scopes.
Quickstart
Platform paths and first API calls.
Usage and billing
Credits and Models HTTP errors.
Troubleshooting
Host-wide diagnostics beyond the extension.