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.
| Command | What it does | Also in |
|---|---|---|
| HQ: Sign In | Approve 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 Out | Sign 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 Account | Sign in to one more HQ account. Sign the browser in as that account first. | Account view, Teams view title (+) |
| HQ: Switch Account | Choose 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: Refresh | Reload your organizations, teams and sessions. | Teams view title |
| HQ: Open Team Files | Add a team's folder to the Explorer. | Team row (folder icon), right-click a team |
| HQ: Search in Team Files | Search a team's files on its AI Team Cloud Computer. | Right-click a team |
| HQ: Attach | Open a session in a terminal. | Session row (click it), right-click a session |
| HQ: New Session Terminal | Start a new session on a team and open it. Needs editor or owner access. | Team row (+), right-click a team |
| HQ: Wake Team | Start 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 Web | Open the team or session in HQ in your browser. | Right-click a team or a session |
| HQ: Manage Devices in HQ | Open 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:
| Command | Where |
|---|---|
| Start Session | A stopped session you may operate, in the Teams view (play icon, or right-click). |
| Stop Session | A running session you may operate, in the Teams view (stop icon, or right-click). Asks first while it is answering. |
| Restart Session | A running session you may operate, in the Teams view (restart icon, or right-click). Asks first while it is answering. |
| Open in Browser | An active forward in the Ports view. |
| Copy Local Address | An active forward in the Ports view. |
| Stop Forwarding | An active or paused forward in the Ports view. |
| Resume Forwarding | A paused forward in the Ports view (or click the row). |
| Forward | A port the Cloud Computer started listening on, in the Ports view. |
| Dismiss | A port the Cloud Computer started listening on, in the Ports view. |
| Open | A result in the Search view (or click the row). |
Views
The AI Workforce One HQ icon in the Activity Bar opens the HQ sidebar:
| View | What it shows |
|---|---|
| Teams | Your organizations, their teams (running, starting or off, plus update needed and view only when they apply) and each team's sessions. |
| Ports | Your forwards (active and paused) and the ports an AI Team Cloud Computer started listening on. |
| Search | The results of HQ: Search in Team Files. Shown after your first search. |
| Account | Every 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.
| Setting | Default | What it does |
|---|---|---|
hq.localEcho | auto | Local echo in HQ session terminals: auto, always or off. See Local echo. |
hq.host | https://hq.aiworkforceone.com | The 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.