# 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 [#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 [#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 [#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](/docs/vscode/terminals/#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 [#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.
