AI Workforce OneHQDocs

Commands and settings

Every command, view and setting the AI Workforce One HQ extension adds to your editor.

This page lists what the extension adds in version 0.4.2.

Commands

Run these from the Command Palette (Ctrl+Shift+P, or Cmd+Shift+P on macOS). Most are also buttons or right-click items in the HQ sidebar.

CommandWhat it doesAlso in
HQ: Sign InApprove this computer in HQ in your browser. Shown while this window has no account. With accounts already signed in on this computer, it opens Choose an account instead.Teams and Account views
HQ: Sign OutSign out of the account this window uses: end its access in HQ and close its terminals and forwards in every window. Asks first when more than one account is signed in.Account view (icon beside each account)
HQ: Add Another AccountSign in to one more HQ account. Sign the browser in as that account first.Account view, Teams view title (+)
HQ: Switch AccountChoose which account this window uses. Nothing closes.Status bar (with more than one account), Teams view title, Account view (click an account)
HQ: Sign Out of Account...Choose an account to sign out of.Account view, Choose an account (icon beside each account)
HQ: RefreshReload your organizations, teams and sessions.Teams view title
HQ: Open Team FilesAdd a team's folder to the Explorer.Team row (folder icon), right-click a team
HQ: Search in Team FilesSearch a team's files on its AI Team Cloud Computer.Right-click a team
HQ: AttachOpen a session in a terminal.Session row (click it), right-click a session
HQ: New Session TerminalStart a new session on a team and open it. Needs editor or owner access.Team row (+), right-click a team
HQ: Wake TeamStart an AI Team Cloud Computer that is off.Team row (play icon), right-click a team that is off
HQ: Forward a Port...Forward an AI Team Cloud Computer's port to this computer. Needs editor or owner access.Ports view title (+), right-click a team
HQ: Open in HQ WebOpen the team or session in HQ in your browser.Right-click a team or a session
HQ: Manage Devices in HQOpen Account, Devices in HQ, where you can remove this computer.Account view

These act on one row of the Teams, Ports or Search view, and are not in the Command Palette:

CommandWhere
Start SessionA stopped session you may operate, in the Teams view (play icon, or right-click).
Stop SessionA running session you may operate, in the Teams view (stop icon, or right-click). Asks first while it is answering.
Restart SessionA running session you may operate, in the Teams view (restart icon, or right-click). Asks first while it is answering.
Open in BrowserAn active forward in the Ports view.
Copy Local AddressAn active forward in the Ports view.
Stop ForwardingAn active or paused forward in the Ports view.
Resume ForwardingA paused forward in the Ports view (or click the row).
ForwardA port the Cloud Computer started listening on, in the Ports view.
DismissA port the Cloud Computer started listening on, in the Ports view.
OpenA result in the Search view (or click the row).

Views

The AI Workforce One HQ icon in the Activity Bar opens the HQ sidebar:

ViewWhat it shows
TeamsYour organizations, their teams (running, starting or off, plus update needed and view only when they apply) and each team's sessions.
PortsYour forwards (active and paused) and the ports an AI Team Cloud Computer started listening on.
SearchThe results of HQ: Search in Team Files. Shown after your first search.
AccountEvery account signed in on this computer (the one this window uses marked "Active in this window"), each with a sign-out icon and Manage devices in HQ, then Add another account... and the HQ address. An account whose sign-in needs renewing says "Sign in again"; click it.

The Teams view shows the teams of the account this window uses; its title shows that account's email.

The status bar shows HQ: and the email of the account this window uses, plus the team and its state while an HQ terminal is the active one (· other account when that terminal works as another account). Click it to open the HQ sidebar, or, with more than one account signed in, Choose an account. A second item counts your active forwards.

A command that needs an account (Wake Team, New Session Terminal, Attach, Forward a Port, Open Team Files, Search in Team Files, Refresh) uses the account of the row you ran it on, else the window's. In a window that has no account, it asks you to choose one first.

Settings

All three are user settings: a team folder's own settings cannot change them.

SettingDefaultWhat it does
hq.localEchoautoLocal echo in HQ session terminals: auto, always or off. See Local echo.
hq.hosthttps://hq.aiworkforceone.comThe HQ address this editor signs in to. For AI Workforce One staff; leave it as it is. Changing it needs a new sign-in.
hq.allowedHosts[]Extra HQ addresses this editor may sign in to. For AI Workforce One staff.

Team file addresses

A team's folder opens at hq://<account>@<organization>/<team>/, where <account> is a short code for the HQ account that opened it and <team> is the team's hq-… name, the same one hq status prints. For example hq://a3f9c01b7e2d4@acme/hq-3f9a1c2e/src/app.py. The code is not a password: it only picks among the accounts already signed in on this computer.

Folders opened with version 0.1 have no account code (hq://acme/hq-3f9a1c2e/). They keep opening as the account that was signed in then.