> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentbees.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Web IDE

> Open any task in a full browser VS Code, wired to the live workspace.

The **Web IDE** gives you full **VS Code in the browser**, running on the **same
repo checkout** as the agent. It's a premium, org-gated capability — great for
jumping in to steer, tweak, or debug alongside the agent.

## Enable it

The Web IDE must be turned on for your org (**Admin → Agent LLM → Enable the Web
IDE**). Once enabled, the New Task form shows an **"Open in Web IDE (VS Code ·
premium)"** toggle.

<Note>
  An IDE-enabled task runs a **dedicated, isolated sandbox** — **1 vCPU / 1 GiB RAM / 1 GiB disk** —
  heavier than the ½ vCPU / 512 MiB base workspace. It counts against your plan's IDE seat limit
  (Pro: up to 3, Team: up to 6), all within the shared pool. You can raise CPU/RAM with pool
  add-ons.
</Note>

## Open it

<Steps>
  <Step title="Create the task with the Web IDE toggle on">
    The task provisions the premium image with VS Code (openvscode) baked in.
  </Step>

  <Step title="Switch to Developer view">On the task screen, toggle **Developer view**.</Step>

  <Step title="Open IDE">
    Click **Open IDE**. A short-lived, authenticated session opens VS Code in an embedded frame on
    the task's live workspace. **Close IDE** hides it again.
  </Step>
</Steps>

<Warning>
  The **Open IDE** button only works on a task that was **started with the Web IDE toggle on**.
  Opening it on a regular task returns "this task was not started with the Web IDE."
</Warning>

## What you can do

* Browse and edit the repo checkout in a familiar VS Code UI.
* Work side-by-side with the agent — you're on the same files.
* Use the integrated terminal in the workspace.

The IDE session is authenticated with a short-lived token and served through a
dedicated, scoped proxy — only the `/ide/` path reaches it, and only for your task.