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.1.0.
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 you are signed out. | Teams and Account views |
| HQ: Sign Out | End this computer's access in HQ and close every HQ terminal and forward. Shown while you are signed in. | Account view |
| 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 machine. | 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 a team machine that is off. | Team row (play icon), right-click a team that is off |
| HQ: Forward a Port... | Forward a team machine'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 Ports or Search view, and are not in the Command Palette:
| Command | Where |
|---|---|
| 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 machine started listening on, in the Ports view. |
| Dismiss | A port the machine 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 a team machine started listening on. |
| Search | The results of HQ: Search in Team Files. Shown after your first search. |
| Account | Your email, the HQ address, Manage devices in HQ and Sign out. |
The status bar shows HQ: and your email, plus the team and its state while an HQ terminal is the
active one. A second item counts your active forwards.
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://<organization>/<team>/, where <team> is the team's hq-… name,
the same one hq status prints. For example hq://acme/hq-3f9a1c2e/src/app.py.