# VS Code overview

The AI Workforce One HQ extension brings your HQ teams into VS Code, Cursor, Windsurf and VSCodium. Open a team's files, join its session terminals and forward its ports, with nothing installed on the AI Team Cloud Computer.



<Callout title="Version 0.4.2.">
  The extension is at version 0.4.2, published on the Visual Studio Marketplace and on Open VSX.
</Callout>

The extension talks only to HQ, with HQ's own permissions, and installs nothing on your AI Team
Cloud Computers. Everything you see and do in VS Code is what your role on that team allows
in HQ, and secrets stay masked, as in HQ.

## What it does [#what-it-does]

* **Sign in** with **HQ: Sign In**. You approve this computer in HQ in your browser, the same way
  as `hq login`. The editor gets its own access, which you can remove at any time in HQ, under
  Account, Devices.
* **Teams**: the AI Workforce One HQ sidebar lists your organizations, their teams (running,
  starting or off) and each team's sessions.
* **Team files**: **Open Team Files** adds a team's folder to the Explorer. Open, edit and save its
  files, and search them on the AI Team Cloud Computer.
* **Session terminals**: open any session you can see in a VS Code terminal. You type in your own
  sessions; other people's sessions are view only. Closing the terminal leaves the session running.
* **Ports**: forward a port from an AI Team Cloud Computer to `localhost` on this computer and open it in
  your browser. Ports the Cloud Computer is listening on are offered to you.

## Before you start [#before-you-start]

* **VS Code 1.90 or newer**, or Cursor, Windsurf or VSCodium.
* **An HQ account** in at least one organization.
* **Developer access on** for your organization. An organization owner turns it on in HQ, under
  Settings, Security, Developer access. Until then the Teams view says
  "No org has developer access on yet."
* **Access to the team.** What you can do depends on your role on each team:

| On a team, you can...        | Viewer     | Editor or owner                      |
| ---------------------------- | ---------- | ------------------------------------ |
| Open its files               | Read only  | Read and save (needs an active plan) |
| Search its files             | Plain text | Plain text and regular expressions   |
| Open its session terminals   | Watch      | Watch, and type in your own sessions |
| Start a new session terminal | No         | Yes (needs an active plan)           |
| Forward a port               | No         | Yes (needs an active plan)           |
| Wake its Cloud Computer      | Yes        | Yes                                  |

## Quick start [#quick-start]

<Steps>
  <Step title="Install">
    Search for **AI Workforce One HQ** in the Extensions view and install it. See
    [Install](/docs/vscode/install/) for Cursor, Windsurf and VSCodium.
  </Step>

  <Step title="Sign in">
    Open the AI Workforce One HQ icon in the Activity Bar and press **Sign in**, or run **HQ: Sign In**
    from the Command Palette. Type the code in the HQ page that opens, and approve this computer.
  </Step>

  <Step title="Open a team">
    In **Teams**, right-click a team and choose **Open Team Files**, or open one of its sessions to
    join its terminal.
  </Step>
</Steps>

## Next [#next]

<Cards>
  <Card title="Install" href="/docs/vscode/install/">
    The Marketplace, Open VSX, and updating.
  </Card>

  <Card title="Sign in" href="/docs/vscode/sign-in/">
    The device approval, where the sign-in is kept, and signing out.
  </Card>

  <Card title="Commands and settings" href="/docs/vscode/reference/">
    Every command, view and setting the extension adds.
  </Card>
</Cards>
