Getting Started · Reference

Command Cheat Sheet

Every slash command you can run in an HQ session. Type the command in Claude Code or Codex — HQ handles the rest.

Session

/startworkStart every session here. Loads company context, policies, workers, and prior session state.
/startwork acme
/handoffEnd every session here. Commits changes, writes thread file, captures learnings, regenerates indexes.
/checkpointMid-session save. Writes a lightweight thread file without ending the session.

Planning

/brainstormExplore 2–3 approaches with effort estimates before committing to a plan.
/brainstorm I want to add real-time notifications to Acme
/planGenerate a structured PRD with user stories, acceptance criteria, and quality gates.
/plan build a notification system for Acme
/deep-planExtended planning with multi-agent research. For large or strategically important projects.

Execution

/run-projectExecute a PRD. Workers handle each story with back-pressure testing between them.
/run-project acme-notifications
/runSpawn a specific worker with a specific skill.
/run frontend-designer ui-review
/execute-taskExecute a single story from a PRD without running the full pipeline.

Cloud & Sharing

/hq-syncSync local HQ with cloud. Bidirectional — pushes local changes, pulls remote updates.
/hq-shareMint an encrypted single-use share link. 15-minute expiry. Recipients pull files into their own HQ.
/hq-share companies/acme/knowledge/api-patterns.md
/designate-teamAdd or manage team members for a company. Controls access to company-scoped resources.
/deployDeploy a web app. Runs build, sensitivity scan, guardrails, and uploads with access control.

Onboarding & Team

/onboardCreate or join a company.
/acceptAccept a vault-backed membership invite from a magic link or token.
/inviteInvite a person to a company. Creates a pending membership and sends an email.
/dmDM a teammate. Delivered to their HQ Sync menubar notification.
/dm jordan can you review the Acme PRD?

Setup & Config

/setupComplete initial HQ configuration after install.
/import-claudeImport existing Claude/Codex projects into HQ. Scans for skills, policies, knowledge, and configs.
/import-claude import my project called my-app in Documents
/hq-secretsManage API keys and credentials. Stored encrypted per-company, auto-injected at runtime.
/hq-secrets add my Stripe key to Acme
/newcompanyScaffold a new company directory with knowledge, policies, workers, and settings.
/newworkerCreate a new worker agent with skills and knowledge pointers.

Knowledge & Learning

/learnCapture operational learnings as policy files. Scoped to company, repo, or global.
/learn --hardCapture a hard-enforcement rule (a NEVER/ALWAYS) into a policy file.
/discoverIngest a repo into HQ. Pulls the repo at latest main, fans out exploration, and synthesizes structured knowledge.
/discover ingest my-app into HQ
/searchSearch across HQ content, repos, projects, workers, policies, and knowledge.

Quality & Review

/reviewCode review with context-aware feedback.
/tddTest-driven development flow. Write tests first, then implementation.
/diagnoseDebug a problem with structured investigation.
/hq-bugReport a bug. Captures session context automatically — no manual repro steps needed.

Account

/hq-loginSign in to your HQ account.
/hq-logoutSign out of your HQ account.
/hq-whoamiShow current identity, org membership, and session info.

These are the most common commands. HQ has many more — type / in any session to see the full list. Commands are context-aware: they load your company policies, knowledge, and prior session state automatically.

Previous05 · Development Concepts