Auren AI for Visual Studio Code
Hosted access
Install the extension, open Auren AI in the activity bar, and select Access code. Enter the eight-digit invitation from your administrator. Hosted chat connects to aiauren.com and uses the server’s models, including any available options under Select model.
The installed release requires an access code and uses the hosted gateway. To use local repository and edit workflows from the Extension Development Host (F5), set Auren: Public Url to an empty string and start the local backend.
In local mode, chat and repository analysis
use the same project IDs and saved conversations as the web workspace. Code proposals
open as read-only snapshots in VS Code's native diff editor.
Local mode requirements
- VS Code 1.95 or newer, running locally with a trusted folder or multi-root workspace.
- Node.js 22 or newer and npm for development and packaging.
- Auren's Python/FastAPI backend on an HTTP loopback address.
- Local Ollama. Install the chat model selected in Auren and
qwen2.5-coder:14b for model-generated edit proposals.
Exact replacements use the backend without model inference.
From the Auren repository, start the backend with the existing virtual environment.
source .venv/bin/activate
python -m pip install -r requirements-workspace.txt
python -m uvicorn api.server:app --host 127.0.0.1 --port 8765 --reload
The extension connects directly to FastAPI. Vite is needed only for the web workspace
and for registering a custom folder through its Projects view.
Develop and launch with F5
- Open the
vscode-extension folder itself in VS Code.
- Run
npm ci and npm run compile in its integrated terminal.
- Press F5 using Run Auren AI. In the Extension Development Host, open a local repository already visible in the Auren Projects view and trust it if you trust its contents.
- Open Auren AI in the activity bar. Use Check connection to see the backend and selected model, or Select repository if automatic detection is ambiguous.
- If a folder is missing, register its authorized location in Auren's Projects view and retry. The extension does not register folders or expand authorization.
Chat and review
Send a message in the sidebar, use New chat to start a fresh conversation, or select
Open chat for server-saved conversations in the selected project. With a saved,
authorized active file, Auren includes that file as context. Stop interrupts the
local wait and requests server-side chat cancellation.
| Command |
Action |
| Ask About Selection |
Ask a question with saved selected text as context. |
| Explain Current File |
Explain an authorized saved source file. |
| Review Code |
Request a source-grounded review and suggested test plan. |
| Find Bug |
Request one supported finding and a proposed diff when available. |
| Propose Fix |
Request a structured Workbench proposal from local Ollama. |
| Propose Exact Replacement |
Select complete original lines and enter one replacement line or leave it empty for deletion. |
| Apply Reviewed Edit |
Confirm and apply the exact proposal ID shown in the native diff. |
| Reject Reviewed Edit |
Dismiss the local review without writing source. |
| Select Repository |
Choose an authorized workspace repository by its canonical path. |
| Check Connection |
Report backend reachability and the current chat model. |
To verify the approval flow manually, request a one-line change in a disposable file,
confirm that the native diff matches the requested edit, and reject it once. Propose
it again, approve using the sidebar or command palette, and confirm the backend
success notice and changed file. To exercise stale-file protection, save a different
edit after opening a proposal. Apply should refuse the outdated snapshot.
Source validation establishes which lines would change. Language correctness and
behavior still require tests. This extension does not run repository commands.
Settings
auren.backendUrl defaults to http://127.0.0.1:8765. Only HTTP loopback hosts are accepted. Backend redirects are refused.
- Auren uses the open Git repository folder. In a multi-folder workspace, focus a source file in the intended folder. On first use, approve access from the VS Code prompt.
Test, package and install locally
npm test
npm run package
Use Extensions → … → Install from VSIX… and select the generated
auren-ai-0.1.0.vsix. Reload VS Code if prompted. Packaging does not publish the extension.
Limits and roadmap
- Local VS Code workspaces only. The backend has no invitation or remote authentication in this MVP. Treat other local users and processes as inside the existing backend trust boundary.
- Source context requires a saved UTF-8 file accepted by Auren. Automatic matching relies on existing repository registrations.
- The extension does not add terminal execution, automatic tests, commits, pushes, deployments, or Salesforce controls.
- Model proposal cancellation aborts the extension wait. The backend only provides a server-side cancellation endpoint for chat, so a cancelled proposal may still finish locally. Reject dismisses the extension preview because the existing backend has no reject endpoint. Unapplied proposals expire on the server.
- v0.2 candidates include authenticated connection support, richer diff review and exact replacement input, and explicit test controls.
Project learning and response timing
Rate a saved project answer Helpful or Incorrect. An optional correction is
saved with the response ID and timestamp. Relevant corrections can guide later
answers and are treated as user guidance. To save an explicit preference or
source-backed fact, open Project lessons. A source fact must match the exact
text of one repository line. If that line changes, the fact is shown as stale and
excluded from future prompts. The same picker can view, correct, or delete lessons.
The sidebar streams retrieval, preparation, and generation status when the
backend supports it. Project answers and diffs appear after backend validation.
Verified excerpts are collapsed below the interpretation. Timing shows backend
retrieval, prompt preparation, inference, and the sidebar's Markdown and DOM
rendering time. It does not measure screen paint or network transfer.