All topics
Browse everything
Getting Started
Install HQ, set it up, and ship your first win.
What is HQ?Anyone who just heard about HQ and wants the plain-English version before installing anything.4 minInstalling HQ on macOSAnyone setting up HQ on a Mac for the first time. No terminal experience needed.6 minInstalling HQ on WindowsAnyone setting up HQ on a Windows PC for the first time. No command-line experience needed.6 minFixing a Failed InstallAnyone whose HQ install stopped partway through, or who can't get the app open or signed in. Find your symptom below and follow the fix.5 minA Tour of the HQ Desktop AppAnyone who's installed HQ and wants to know what everything in the app does.6 minUsing HQ with Claude CodeAnyone who wants to run HQ with Claude Code, Anthropic's coding assistant. It's the tool most HQ users run. No terminal experience needed.7 minUsing HQ with CodexAnyone who wants to run HQ with Codex (OpenAI's coding assistant, part of the ChatGPT app) instead of, or alongside, Claude Code. No terminal experience needed.7 minYour First 30 Minutes: What Setup DoesAnyone who just installed HQ and is about to run setup, or is mid-setup and wondering what's happening.8 minYour First Win: Ship Something Real TodayAnyone who finished
/setup and is now staring at the screen thinking "…okay, now what?" You are not alone. This is the most common moment to get stuck.6 minDaily Use
The everyday rhythm: plan, build, find, share, and teach HQ.
The Daily Loop: /startwork → work → /handoffAnyone who uses HQ day to day and wants a simple, repeatable rhythm.5 minSessions, Checkpoints, and HandoffsAnyone whose sessions get long, slow, or die mid-task, which is everyone, eventually.4 minFrom Idea to ShippedAnyone with a project in mind who wants to know which planning command to use and how execution actually works.5 minFinding Anything in HQAnyone who's thought "I know HQ has this somewhere", and wants it back in seconds.4 minMessaging in HQAnyone using the HQ desktop app to talk with teammates, clients, and bots.5 minSharing Your WorkAnyone who's finished something in HQ and needs to get it in front of a person, a teammate, a client, or the whole company.6 minGetting Feedback with Comments on Your DeploysAnyone who's shared a page with
/deploy and wants feedback right on the page, and anyone who's been sent a page to comment on.3 minTeaching HQ: /learn, Policies, and Why Knowledge CompoundsAnyone who has corrected HQ twice on the same thing and would like to never do it a third time.5 minLocal BotsAnyone who wants their own AI helper in HQ that they can message like a teammate.6 minUsing HQ from ChatGPT and Claude.aiAnyone who wants their team's HQ knowledge, files, and projects available inside ChatGPT or Claude.ai, with no install required. The setup section near the end is for Champions.6 minHQ Bots in SlackAnyone who wants HQ answering questions inside Slack. The everyday section is for everyone; connecting a workspace is Champion and workspace-admin territory.5 minConnecting Your Apps to HQAnyone who wants HQ to look things up or take action in the apps their team already uses, like Linear, Notion, or Sentry. The connecting and permissions parts are for company owners and admins.4 minHow HQ Works
The mental model and the product family behind it.
The HQ Mental ModelAnyone who has installed HQ and wants to understand how it's organized before diving in.4 minCompanies, Projects, and Repos: How They Fit TogetherNew HQ users who see three container-like concepts and aren't sure which holds which.4 minCommands vs Skills vs WorkersAnyone who has heard all three words and isn't sure which one they're supposed to use.4 minThe HQ Ecosystem: Every Product, ExplainedAnyone who has seen names like hq-core, hq-cloud, or hq-deploy and wondered what they are, and which ones they actually use.5 minCapability Packs: Installing and Managing ThemBuilders and champions who want to add capabilities to HQ, and anyone wondering why a command from the docs is missing on their machine.5 min
Teams & Cloud
Sync, secrets, meetings, and rolling HQ out to a team.
Permissions in HQ: Who Can See WhatCompany owners and leaders who want to know exactly who can see their files in HQ, especially sensitive ones. Also useful for anyone setting HQ up for a team.8 minHQ Cloud: What It Is and Whether You Need ItAnyone deciding whether to connect HQ to the cloud, solo users, team members, and team leads alike.5 minSync: How It Works and How to Fix ItAnyone using HQ with a team or on more than one computer.6 minStorage and Disk SpaceAnyone whose computer is running low on space, or who wants to know how much room HQ takes up.5 minRolling HQ Out to Your Team: The Champion's GuideThe person bringing HQ to their team, you'll set up the shared workspace and get everyone else in.7 minConnecting Your Tools Safely: The Secrets GuideAnyone who wants HQ to use their tools: email, databases, Stripe, anything with an API key or password.6 minMeeting Notes and Signals: Never Lose an Action Item AgainAnyone whose week runs on meetings, and Champions deciding whether to turn this on for the team.5 minCloud BotsAnyone whose company has a cloud bot, or is about to get one. The first half is for everyday users who just want to talk to a bot in Slack or by email. The second half is labeled For Champions and covers creating, securing, and operating cloud bots.15 min
Help & Reference
Stuck? Quick answers, the glossary, and where to get more help.
The "I'm Stuck" GuideAnyone whose HQ isn't doing what they expected. Find your symptom below and follow the fix.5 minFrequently Asked QuestionsAnyone with a quick question about HQ. Scan the section headings to find yours.6 minHQ GlossaryAnyone who hits an unfamiliar HQ term. Every term, 1 to 3 plain sentences, alphabetized.6 minGetting More HelpAnyone who has read the docs and still needs a hand, or wants to know the best channel for a given question.4 minEvery HQ Command at a GlanceAnyone who wants the full menu: every HQ command on one page, with a one-line purpose and a link to the article that teaches it.10 minDeploying Your Own Web AppBuilders with a real web application (Next.js, Remix, Astro, Vite) who want it live on the internet through HQ's deploy platform.4 minDeploying Full-Stack Apps: Next.js and HonoBuilders who want to put a full web app, with its own server code, on HQ Deploy. If you're sharing a report or a simple page, Sharing Your Work is all you need.2 min