Get your HQ set up

Run /import-claude and point HQ at your existing Claude or Codex projects, repos, or loose files. HQ scans for plans, commands, skills, hooks, policies, knowledge files, and MCP configs — then structures them into your company directory.

HQ is an umbrella for all your context. The more context you migrate, the smarter every session becomes — your AI tools draw from the full picture instead of starting cold each time. Import early, import everything.

Deploy a small app to verify your deploy pipeline works end to end. Run /deploy and HQ orchestrates the full flow: build, sensitivity scan, localhost preview, access mode selection, and upload — with guardrails that block oversized or misconfigured deployments.

A test deploy catches config issues early — missing env vars, broken build commands, oversized bundles — before they block real work. Choose an access mode: public (no gate), password-protected, or private (email allowlist).

Use hq secrets to manage API keys, tokens, and credentials. Secrets are stored securely per company and injected automatically when you run commands — no .env files floating around your repo.

Declare what your project needs in .env.schema with hq() markers. When you run hq run, secrets are resolved and injected — no manual wiring.

Skills are single-responsibility capabilities — a focused task defined in a SKILL.md file and invoked via slash command. Workers are full agents that own multiple skills, have their own identity and knowledge context, and are spawned as separate sessions via /run.

Start with skills for simple automations. Graduate to workers when a domain (design, security, deploy) has enough skills and context to justify a dedicated agent.

Everything you build — knowledge, skills, workers, policies — stays local until you sync. Run /hq-sync to push to the cloud, or hit Sync in the app bar. Share specific files or directories with teammates via /hq-share — it mints an encrypted link that grants them access to the shared vault paths via a browser picker. Build the habit early: sync often, share generously.

Found a bug or have a suggestion? Run /hq-bug from any session. It captures your current context (session state, recent commands, environment) and files a structured report — no manual reproduction steps needed.