All articles
On this page
Help & Reference
Frequently Asked Questions
Anyone with a quick question about HQ. Scan the section headings to find yours.
The questions new users actually ask, grouped by topic. Each answer links to a fuller article if you want the details.
Getting started#
What is HQ, in one sentence?
HQ is an AI operating system for your work: a shared home for your team's knowledge, projects, and AI helpers, so the AI you work with actually knows your business and gets smarter over time. Full explanation: What is HQ?
Do I have to know how to code?
No. Most everyday HQ users never touch code. You type plain-English requests and commands (like /prd or /startwork) into the HQ app, or into Claude Code or Codex, which are chat windows for AI work. The few unavoidably technical steps (like installation) are spelled out click-by-click in Installing HQ on macOS and Installing HQ on Windows.
What's the difference between /setup, /onboard, and /accept?
These three get confused constantly, so here's the rule of thumb:
/setup: sets up your HQ. Run it once, when you first install. It asks who you are and what you work on, then builds your personal workspace./onboard: connects you to a company (a shared workspace for a business or team). Use it to create a new company or join an existing one./accept <token>: for older invite links. Most invites now just need you to sign in to HQ with the email the invite went to.
So: /setup = you (once), /onboard = a company (create or join), /accept = older invite links.
Does HQ work on Windows?
Yes. HQ runs on Mac and Windows. Follow Installing HQ on macOS or Installing HQ on Windows. If the installer fails, see Fixing a Failed Install.
I finished setup. Now what?
Head to Your First Win, a guided first project you can finish in one sitting. Or run /tutorial for interactive lessons.
Working#
Where did my skill save?
When you create a skill (a saved, repeatable workflow), it lands in one of two places depending on who it's for:
- Just for you: under
personal/in your HQ folder, your private overlay. - For a company/team: under
companies/{company-name}/, where teammates can get it via sync.
If you can't find one, run /search with the skill's name. For the full map of where things live, see Commands, Skills, and Workers and The HQ Mental Model.
What happens if I close my laptop mid-task?
The session pauses; nothing is deleted. When you come back, reopen Claude Code and continue the conversation, or start fresh with /startwork to reload your saved context. If the session had already hit an error or a context limit, /recover-session reconstructs it. Long-running background work is the exception. If an autonomous task was mid-flight, it stops with your laptop and resumes when you re-run it. See Sessions and Handoffs.
Why doesn't HQ remember our last conversation?
By design, each session starts fresh. Chat history is disposable, but files are forever. Anything worth keeping gets written to your HQ folder (via /handoff, /learn, or the work itself), and /startwork loads it back at the start of the next session. If you find yourself repeating an instruction, make it permanent with /learn. See Teaching HQ.
When should I use /prd vs /deep-plan vs /idea?
It's a ladder based on how baked the idea is: /idea captures a one-liner for later. /brainstorm fleshes out a fuzzy idea. /prd produces a standard project plan (PRD) and is right for about 90% of projects. /deep-plan is for big or strategic work. It does deeper research and a longer interview. Full walkthrough: From Idea to Shipped.
Why was my image blocked?
Image reads are limited by file size, not by how many images you send. Any single image over 2 MB is blocked, and each session also has a total image budget (about 8 MB, or 32 different images). To fix it, shrink or crop the image below 2 MB, or start a fresh session if you've already shared a lot of images in this one.
Teams & cloud#
Can I use HQ without the cloud / offline?
Yes. Solo, offline HQ is fully supported. Everything lives in a folder on your machine. The desktop app asks you to sign in once, and the free self-hosted setup runs without an HQ account. The cloud (HQ Cloud) is optional; you add it when you want backup across machines or team features like sharing and syncing. You can start solo and turn on cloud later without redoing anything.
Can HQ see my other companies' data?
No, and this is a hard rule, not a convention. Each company under companies/ is an isolated tenant: its knowledge, credentials, and files never mix with another company's, and HQ treats any cross-company leak as a serious bug. If you work with multiple businesses, each gets its own sealed compartment. Details: Companies, Projects, and Repos.
How do I share something I made?
For a page, report, or deck, ask HQ to "deploy this" (or type /deploy) and you'll get a web link. You choose who can open it: anyone, people with a password, your company, or specific email addresses. To give a teammate access to files, use /hq-share. To send a quick note, use /dm. See Sharing Your Work.
My teammate can't see what I shared. Why?
Usually one of three things: you're not signed in (/hq-login), the company isn't cloud-backed yet (/designate-team), or sync hasn't run since you shared (/hq-sync). Step-by-step fix: The "I'm Stuck" Guide.
How do I update HQ?
Run /update-hq. It upgrades the core HQ scaffold to the latest release without touching your personal files, company data, or customizations. Those live in personal/ and companies/, which updates never overwrite.
Data & privacy#
Where does my data live?
On your machine, in your HQ folder. If you enable HQ Cloud, cloud-backed companies also sync to an encrypted vault so teammates and your other machines can access them. Secrets (API keys, passwords) are stored encrypted and are never pasted into chat. See the Secrets Guide.
Is my data used to train AI models?
No. HQ doesn't use your data, including meeting notes and connected-app data, to train or fine-tune AI models, and its agreements with the AI providers it uses don't let them train on it either. Most of HQ's cloud-side AI runs on AWS Bedrock (Claude models hosted inside AWS), including meeting signals. Live meeting voice features use other AI providers. One exception to know about: the AI tools on your own machine (Claude Code, Cursor, Codex) use your own AI account, under that provider's terms. Some personal AI plans let the provider train on your conversations unless you turn that off, so check your account's settings. The full statement is in HQ's privacy policy, and you can email privacy@hqforwork.com with questions.
Who can see what I put in a company folder?
It depends on the folder and the person's role. When a company is connected to the cloud, every member can see its four shared folders (knowledge/, projects/, policies/, and skills/). Everything else is private unless it's shared with someone. Owners can see everything and manage roles with /promote. Admins can see the company's files too, though an owner can limit that and decides whether admins can change roles. Your personal/ folder is yours alone. Details and safe setup for HR and payroll files: Permissions in HQ.
Billing & product#
How is HQ different from just using ChatGPT or Claude?
A plain chat assistant starts every conversation knowing nothing about you, and everything you teach it evaporates when the chat ends. HQ wraps the AI in a persistent, shared structure: your company's knowledge, policies, and past decisions are on disk, loaded into every session, and shared with your team. Ask ChatGPT to "write our weekly update" and you'll re-explain your business every time; ask HQ and it already knows your projects, your tone rules, and what happened last week. The AI is the engine. HQ is the memory, the filing system, and the team layer. More: What is HQ? and Teaching HQ.
Do I need a paid plan?
No. There's no plan fee. You can run HQ self-hosted on your own machines for free. HQ Cloud (sync, sharing, the encrypted vault, and the other hosted features) is $0 a month plus usage: you pay only for what you use, and every month includes $10 of usage. New accounts get a 30-day free trial, and you don't need a card to start. Deploys, DMs, and background AI are free, and people are never billed per seat. Cloud bots are the main extra: each one runs on its own machine with a monthly fee based on size, while bots you run on your own computer have no machine fee. Billing is per company, so each company pays for its own usage, and you can create as many companies as you like. Current prices, trial terms, and a link to book a setup call are on hqforwork.com/pricing. Advanced, enterprise, and government teams can also run HQ self-hosted or on-prem; see the self-hosted guide. Already on an older plan? You can see your usage and invoices on the Billing page in the HQ console, and email support@hqforwork.com with billing questions.
Common questions#
Where do I ask a question that isn't answered here?
Run /hq-bug feature with your question. Feature requests and questions both reach the team with your context attached. To reach a person, email support@hqforwork.com. More options: Getting More Help.
Is there a way to learn HQ interactively instead of reading?
Yes. Run /tutorial for hands-on lessons that use your real HQ.
If you get stuck#
If your question is really a "something's broken" situation, go to The "I'm Stuck" Guide. It's organized by symptom. Still stuck after that? Run /hq-bug with a one-line description; it attaches your session context automatically.