> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ageneral.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# VS Code
> Ageneral Coder extension and Ageneral Models in Visual Studio Code
## 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-coder`** when an **Ageneral** model is selected in built-in Chat.
The coding agent starts a **local helper process** the first time you use it.
***
## Contents
* [Requirements](#requirements)
* [Install](#install)
* [Sign in and start](#sign-in-and-start)
* [Features](#features)
* [Settings](#settings)
* [Troubleshooting](#troubleshooting)
* [Next steps](#next-steps)
***
## 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 |
Extensions that register language models must follow [Microsoft’s Chat guidance](https://code.visualstudio.com/docs/copilot/copilot-chat).
***
## Install
### From Marketplace
1. Open **Extensions** in VS Code.
2. Search for **Ageneral** and install **Ageneral Coder**, or open **[Ageneral.ageneralcoder](https://marketplace.visualstudio.com/items?itemName=Ageneral.ageneralcoder)**.
### From VSIX
```bash theme={"theme":{"light":"material-theme-lighter","dark":"material-theme-palenight"}}
code --install-extension ageneralcoder-.vsix
```
(`@vscode/vsce package` writes `{name}-{version}.vsix` from `package.json`; **`name`** is **`ageneralcoder`**.)
Or use **Extensions** → **⋯** → **Install from VSIX…**.
Uninstall:
```bash theme={"theme":{"light":"material-theme-lighter","dark":"material-theme-palenight"}}
code --uninstall-extension ageneral.ageneralcoder
```
***
## Sign in and start
1. Open **Ageneral Coder** in the activity bar. The sign-in view remains until the account links.
2. Run **Ageneral: Sign In** from the Command Palette or the chat menu; finish OAuth in the browser.
3. When sign-in completes, the Chat pane is ready and **Ageneral Models** appear in built-in Chat.
4. 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](#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, not **`settings.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** |
Search **`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 and **`vscode://`** 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
Sign-in, virtual keys, and credential scopes.
Platform paths and first API calls.
Credits and Models HTTP errors.
Host-wide diagnostics beyond the extension.
Install in Visual Studio Code