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.
The extension is at version 0.4.2, published on the Visual Studio Marketplace and on Open VSX.
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
- 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
localhoston this computer and open it in your browser. Ports the Cloud Computer is listening on are offered to you.
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
- Install
Search for AI Workforce One HQ in the Extensions view and install it. See Install for Cursor, Windsurf and VSCodium.
- 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.
- Open a team
In Teams, right-click a team and choose Open Team Files, or open one of its sessions to join its terminal.