---
title: "Alran Code for VS Code: the agent next to your code"
url: https://alran.dev/en/vscode
locale: en
updated: 2026-11-16
---

Alran Code · VS Code

# The agent, right next to your code.

Plan, build and review without leaving the editor. The same Alran Code as in the terminal, now in VS Code, Cursor, Windsurf and VSCodium.

[Get the extension](https://github.com/Alran-AI/vscode)
[Start free](https://ai.ottili.one)

## Everything the terminal does. With a mouse, too. {#h-feat}

### A chat that shows its work

Plans, tool calls and diffs stream in as they happen. Several sessions in tabs.

### Context in one keystroke

`@` adds files, a shortcut adds your selection, images go in by paste.

### Steer while it works

Enter steers the running task, Ctrl+Enter queues the next one, Esc stops.

### Approve with one click

Commands that need you show up as cards, with a preview and an Open diff button.

### Every change, reversible

The Changes view lists what a session touched. Revert one file or all of them.

### Same agent, same config

Sessions, goals, skills, plugins and MCP servers are shared with the terminal.

### Plugin Store and Skill Library

Search, install and update Plugins and Skills from the editor. A Plugin that runs commands waits for your approval.

### Your account in the editor

Sign in from the editor, see credit and spending, and pick a model with its price in front of you.

### Errors with a next step

When a model needs credit or a limit is hit, a card says so and offers the way forward.

## A closer look. {#h-shots}

### A task, from request to result

Alran edits the file, explains what it did and points to where you can review it.

### Every edit as a diff

The diff opens next to your code, next to the conversation that made it. Revert one file or all.

### A yes before it leaves your project

A write outside the project shows up as a card with a preview, and waits.

### The Plugin Store

Search, read what is inside, install. Plugins that run commands show every command first.

### The Skill Library

The same catalogue as single Skills, grouped, and searchable by name, group and description.

### Models with their price

Each model shows what it costs and whether you can use it now. The star sets the default.

### Your account at a glance

Company, project, default model, credit and this month’s spending, in the sidebar.

### Errors you can act on

Claude without your Anthropic key becomes a card: add the key, or switch to Ottili Werk.

### Every command of the terminal

Type a slash to see all commands and your Skills.

Not a terminal person?

## Use it without the terminal. {#h-real}

Describe the task in a chat next to your code. Alran plans it, edits your files and runs your tests. You review every change as a diff, decide what it may do, and undo it with one click. The terminal is still there when you want it: one click opens the same session in it.

- It runs on your machine, and your code stays there. No telemetry.

- Start in the editor, continue in the terminal, or the other way round: it is one session.

- Off in untrusted workspaces; Full Access asks first.

Open the chatCtrl+Alt+A

New sessionCtrl+Alt+N

Add the selectionCtrl+Alt+L

Explain the selectionCtrl+Alt+E

Choose a modelCtrl+Alt+M

Plan Mode on or offCtrl+Alt+P

Plan Mode in the composerShift+Tab

Stop the running turnEsc

On Windows the shortcuts use Ctrl+Shift+Alt, so AltGr characters such as @ keep working. On macOS, Cmd+Alt.

## Set up in three steps. {#h-setup}

1. **Install the CLI.** The extension runs the agent you have installed. It needs Alran Code 0.9.0 or newer.curl -fsSL https://alran.dev/install.sh | bash

2. **Add the extension.** Search for “Alran Code” in the Extensions view: VS Code Marketplace, or Open VSX for Cursor, Windsurf and VSCodium. VS Code 1.90 or newer.github.com/Alran-AI/vscode

3. **Sign in and go.** Sign in with your Ottili account, open the Alran panel and describe a task.alran auth login

[Set up the extension](https://alran.dev/en/docs/vscode)
