# AI Workforce One HQ Docs > Guides for HQ, and reference for the hq CLI, the VS Code extension and the HQ API. ## Start here - [Agency keys](/docs/raw/api/agency-keys/index.md): One key for your agency, acting for one client at a time with the HQ-Account header. What it can do, what it never can, and how your clients stay in control. - [AI Workforce One HQ Docs](/docs/raw/index.md): Guides for HQ, and reference for the hq CLI, the VS Code extension and the HQ API. Run AI Teams on their own Cloud Computers, from HQ, your terminal, your editor or your code. ## Guides: Get started - [What is HQ](/docs/raw/get-started/index.md): HQ is where you run AI Teams. Each AI Team has its own Cloud Computer, where AI Employees such as Claude Code work in sessions, on a schedule, while you are away. - [Quickstart](/docs/raw/get-started/quickstart/index.md): Create your account, add your first AI Team and start your first session in about 5 minutes. - [Sign in and switch organizations](/docs/raw/get-started/sign-in/index.md): Sign in to HQ, switch between the organizations you belong to, create another organization and sign out. ## Guides: AI teams - [Cloud Computer sizes and Boost](/docs/raw/ai-teams/cloud-computers/index.md): Every AI Team runs on its own Cloud Computer. Boost gives a team more processors, memory and concurrent sessions. Organization owners and admins change the size. - [Create an AI Team](/docs/raw/ai-teams/index.md): An AI Team is a team of AI Employees with its own Cloud Computer, files, secrets and schedules. Organization owners and admins create them. - [AI Team settings](/docs/raw/ai-teams/settings/index.md): Rename a team, decide who can see its sessions, set a team API key, turn on the browser and remove your saved sign-ins. Team owners change a team's settings. - [When a Cloud Computer sleeps](/docs/raw/ai-teams/sleep/index.md): An AI Team Cloud Computer that nobody is using goes to sleep and wakes exactly as it was. What keeps it awake, and what happens to a question Claude asked that nobody answered. - [Storage for AI Teams](/docs/raw/ai-teams/storage/index.md): How your organization's storage is shared by its AI Teams, how a team's disk grows, and how owners and admins set a cap or a reserve for each AI Team. ## Guides: Sessions - [Browser View](/docs/raw/sessions/browser-view/index.md): Watch the web browser your AI Employee uses, take control when a page needs a person, answer a Needs you request, attach workspace files to a page and stay signed in to sites. - [Files](/docs/raw/sessions/files/index.md): Browse, open, edit, upload and download the files on an AI Team's Cloud Computer from any session. Viewers read files; editors and team owners change them. - [Session history](/docs/raw/sessions/history/index.md): Scroll back to the start of a session, exactly as it looked live, and download its history. Anyone who can see a session can read its history. - [Start and stop sessions](/docs/raw/sessions/index.md): A session is one conversation with an AI Employee on an AI Team's Cloud Computer. Editors and team owners start them; a session runs until someone stops it. - [Preview your app](/docs/raw/sessions/preview/index.md): When a session runs a web app on its Cloud Computer, open it in your browser at a private address. Anyone on the team can open a preview; editors can use it. - [Terminal and chat](/docs/raw/sessions/terminal-and-chat/index.md): Work with an AI Employee in the session's terminal, or read and answer it in the chat view. The session owner types; everyone else on the team can watch. ## Guides: Schedules - [Schedules](/docs/raw/schedules/index.md): Have an AI Employee start work on its own, at the days and times you choose, whether you are online or not. Editors and team owners create schedules. ## Guides: Secrets and variables - [Secrets and variables](/docs/raw/secrets/index.md): Give your sessions the keys, tokens and settings they need. Secrets are encrypted and masked; variables are plain settings. Owners and admins manage organization secrets. - [My secrets and variables](/docs/raw/secrets/personal/index.md): Personal secrets and variables apply only to the sessions you own that sign in with your own account. Only you can see them. ## Guides: People and access - [People and access](/docs/raw/people/index.md): Invite people to your organization, choose their role, and decide which AI Teams each person can see and change. Owners and admins manage people. - [Roles and permissions](/docs/raw/people/roles/index.md): Decide what each person can see and do in your organization and on each AI Team, with system roles on every plan and custom roles on Professional and Enterprise. ## Guides: Billing and plans - [Billing and plans](/docs/raw/billing/index.md): See your plan and usage, change plan, add AI Teams, Boosts and storage, update your card, get invoices and cancel. Owners and admins manage billing. ## Guides: Security and administration - [Audit log](/docs/raw/security/audit-log/index.md): A record of who did what in your organization, newest first, that you can filter and export. Owners and admins read it. - [Data export](/docs/raw/security/data-export/index.md): Get a copy of everything your organization keeps with AI Workforce One HQ, including the files on your AI Teams' Cloud Computers, and how an erasure request works. - [Support access](/docs/raw/security/support-access/index.md): What AI Workforce One HQ Support can see when it helps you, how to let it read session transcripts and files for a few hours, and how to see every time it looked. - [Two-factor authentication](/docs/raw/security/two-factor/index.md): Add a code from an authenticator app to your sign-in, and require it for everyone in your organization. Everyone sets up their own; owners require it. ## Developers - [Developers](/docs/raw/developers/index.md): Use HQ from your terminal with the hq CLI, from your editor with the VS Code extension, and from your own code with the HQ API. ## Developers: CLI - [Attach to a session](/docs/raw/cli/attach/index.md): hq attach joins an HQ session in this terminal, streaming its output live. Only the session owner can type; everyone else watches. - [Docker in a team](/docs/raw/cli/docker/index.md): Run docker, docker compose and local stacks like Supabase inside a team's sessions, and reach them with Preview or hq forward. - [CLI overview](/docs/raw/cli/index.md): hq connects this computer to your AI Team Cloud Computers. Sign in once, then follow sessions in your terminal and forward ports. - [Install](/docs/raw/cli/install/index.md): Install hq with npm. It needs Node.js 20 or newer, has no dependencies, and runs no install scripts. - [Port forwarding](/docs/raw/cli/port-forwarding/index.md): hq forward makes a port on the AI Team Cloud Computer reachable on this computer, for a dev server, an API or a database. - [CLI reference](/docs/raw/cli/reference/index.md): Every hq command, its flags, an example and its exit codes. - [Start and stop sessions](/docs/raw/cli/sessions/index.md): hq sessions lists the sessions in your teams; hq start, hq stop and hq restart run them from your terminal, with the same rules as HQ. - [Sign in](/docs/raw/cli/sign-in/index.md): hq login signs this computer in with a one-time code that you type into HQ in your browser. No password or key ever passes through the terminal. - [Troubleshooting](/docs/raw/cli/troubleshooting/index.md): The messages hq prints, what each one means, and the fix. ## Developers: VS Code - [Team files](/docs/raw/vscode/files/index.md): Open a team's folder in the Explorer, edit and save its files on the AI Team Cloud Computer, and search them with HQ's own search. - [VS Code overview](/docs/raw/vscode/index.md): 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. - [Install](/docs/raw/vscode/install/index.md): Install AI Workforce One HQ from the Visual Studio Marketplace in VS Code, or from Open VSX in Cursor, Windsurf and VSCodium. - [Ports](/docs/raw/vscode/ports/index.md): Forward a port from an AI Team Cloud Computer to localhost on this computer, open it in your browser, and forward the ports a session starts. - [Commands and settings](/docs/raw/vscode/reference/index.md): Every command, view and setting the AI Workforce One HQ extension adds to your editor. - [Sign in](/docs/raw/vscode/sign-in/index.md): Sign in by approving this computer with a one-time code that you type into HQ in your browser. Your editor gets its own access, separate from the hq CLI. - [Terminals and local echo](/docs/raw/vscode/terminals/index.md): Open an HQ session in a VS Code terminal, start a new one, wake an AI Team Cloud Computer, and see what you type at once with local echo. - [Troubleshooting](/docs/raw/vscode/troubleshooting/index.md): The messages the AI Workforce One HQ extension shows, what each one means, and the fix. ## Developers: API - [Authentication](/docs/raw/api/authentication/index.md): API keys, the difference between your own keys and service keys, scopes, expiry, allowlists, rolling and revoking. - [API changelog](/docs/raw/api/changelog/index.md): What changed in the HQ API, by dated version. - [Deprecation policy](/docs/raw/api/deprecation-policy/index.md): How much notice you get before anything in the HQ API goes away. - [Errors](/docs/raw/api/errors/index.md): Every HQ API error is an RFC 9457 problem document. This page lists every code. - [Idempotency](/docs/raw/api/idempotency/index.md): Retry a write safely with an Idempotency-Key, and know when a key is required. - [HQ API overview](/docs/raw/api/index.md): Drive your AI teams from your own code, CI jobs and products with the HQ API. - [OAuth apps](/docs/raw/api/oauth/index.md): Let your product act for a person in HQ with their consent. Authorization code with PKCE, refresh rotation, revocation and what an app can never do. - [Operations](/docs/raw/api/operations/index.md): Follow a Cloud Computer start, stop, update or resize until it finishes. - [Pagination](/docs/raw/api/pagination/index.md): Cursor pagination with limit, starting_after and ending_before. - [API quickstart](/docs/raw/api/quickstart/index.md): Create an API key and make your first HQ API calls in a few minutes. - [Rate limits](/docs/raw/api/rate-limits/index.md): Requests per minute per key and per organization, and the headers that report them. - [API keys](/docs/raw/api/reference/api-keys/index.md): The keys of your organization. Read only; create, roll and revoke keys in HQ. - [Audit log](/docs/raw/api/reference/audit/index.md): The organization's audit log. - [Billing](/docs/raw/api/reference/billing/index.md): Your plan, this period's usage and your invoices. Read only. - [Cloud Computers](/docs/raw/api/reference/cloud-computers/index.md): The machine each AI team runs on. - [Essentials](/docs/raw/api/reference/essentials/index.md): Health, the contract itself, and the calling credential. - [Files](/docs/raw/api/reference/files/index.md): The files on an AI team's disk, addressed through one of its sessions. Paths are relative to the team's files; a path that leaves them is refused. Reads are masked like the terminal. - [API reference](/docs/raw/api/reference/index.md): Every endpoint of the HQ API, grouped by resource. - [Operations](/docs/raw/api/reference/operations/index.md): Long-running changes to a Cloud Computer, and how they settled. - [Organization](/docs/raw/api/reference/organization/index.md): Your organization, its people and its pending invitations. - [Schedules](/docs/raw/api/reference/schedules/index.md): Schedules and their run history. - [Secrets](/docs/raw/api/reference/secrets/index.md): Secret names and where they apply. A secret value is never returned. - [Sessions](/docs/raw/api/reference/sessions/index.md): The sessions running on your AI teams. - [AI teams](/docs/raw/api/reference/teams/index.md): AI teams, who can reach them, and their AI Employees. - [Templates](/docs/raw/api/reference/templates/index.md): The AI team templates your organization owns. - [Variables](/docs/raw/api/reference/variables/index.md): Plain configuration values, organization-wide and per AI team. - [Webhooks](/docs/raw/api/reference/webhooks/index.md): Signed HTTPS callbacks for your organization's events, their delivery log, retries and replays, and the events list. Verify every delivery with a Standard Webhooks library. - [Python SDK](/docs/raw/api/sdks/python/index.md): The HQ API for Python, with retries, idempotency, a resumable event stream and webhook verification built in. - [TypeScript SDK](/docs/raw/api/sdks/typescript/index.md): The HQ API for TypeScript and JavaScript, with retries, idempotency, a resumable event stream and webhook verification built in. - [Sessions and prompts](/docs/raw/api/sessions-and-prompts/index.md): Start a session, send it a prompt, follow the delivery, answer its questions. - [Streaming a session](/docs/raw/api/streaming/index.md): Follow a session live with server-sent events, and resume after a disconnect. - [Versioning](/docs/raw/api/versioning/index.md): How dated HQ-Version headers keep your integration stable. - [Webhooks](/docs/raw/api/webhooks/index.md): Get a signed HTTPS request when something happens in HQ, verify it, and recover from failures. ## Changelog - [Changelog](/docs/raw/changelog/index.md): What is new, improved and fixed in AI Workforce One HQ, the hq CLI and the VS Code extension, newest first.