Knowledge Hub

The HQ Knowledge Hub

Plain-English guides to HQ, from your first install to rolling it out across your whole team.

On this page

Daily Use

HQ Capture: Record a Process Once and Get a Guide

4 min read Updated Nov 2026

Mac users who want to show HQ how they do something once and get back a clean video and a step-by-step guide.

HQ Capture is HQ's own screen recording pack. You record a process on your Mac from a company session. HQ saves your screen, your camera, and your narration as separate layers. Then the AI in that session summarizes the recording, trims it, places the camera, exports the video, and drafts a step-by-step guide for you to check.

What you need#

  • A Mac with Apple Silicon.
  • macOS 26 or later.
  • Apple's Command Line Tools. HQ Capture builds its recording app on your Mac from source, so it needs these installed. To install them, open Terminal and run xcode-select --install. You don't need full Xcode or an Apple developer account.

Step 1: Install the pack#

Open the HQ Capture pack page. You can copy the install command there and run it, or add your email on the page to get the in-app install:

shell
$ hq install marketplace:hq-capture

More on packs in Capability Packs.

Step 2: Record a process#

Open a session in the company the recording belongs to, then run:

shell
/record-process

The first time, it builds the HQ Capture app on your Mac before opening it, so give it a moment. Then the HQ Capture window opens.

  1. Pick your screen, camera, and mic. You can turn the camera and mic off if you only want the screen.
  2. Click Start recording. The first time, macOS asks for Screen Recording, Camera, and Microphone permission. Approve each one. For Screen Recording, macOS asks you to Quit and Reopen the app. Do that, and HQ Capture comes back ready for the same company. If more than 10 minutes go by, run /record-process again.
  3. Do the process the way you normally would, and talk through it if you like. A small control bar floats over your screen with the time, Pause, and Stop. It doesn't show up in the recording.
  4. Click Stop when you're done.

HQ Capture saves the recording to that company's recordings folder and tells you to go back to your HQ session.

Step 3: Edit by asking#

Back in your HQ session, it summarizes what you recorded. Tell it what to change in plain words, for example "cut the part where I said um." It makes the edit for you. The AI reads the transcript, the guide drafts, and still images from the recording, so you can keep editing by conversation until it looks right.

You can also ask it to move, resize, or hide the camera, show you still frames, and export the video.

You also get a written step-by-step guide. Ask for changes in the chat, like reordering, rewording, or dropping steps, or picking a different screenshot. When it looks right, tell HQ you approve it, and it exports the guide. If you change anything after approving, you'll need to approve it again.

If your session closed before you finished, HQ Capture shows a prompt you can copy. Paste it into a new session in the same company to pick up where you left off.

Privacy#

  • Recording, transcription, and guide drafting all run on your Mac.
  • Nothing is uploaded to any other service or shared with another company.
  • Recordings stay in the company's recordings folder on your Mac (companies/<company>/recordings/ in your HQ folder). They upload to your company's HQ files only when you say yes.

For how company files and sharing work, see Permissions in HQ: Who Can See What.

Finding things in a recording#

Because HQ has the transcript and the guide drafts, you can ask the session about what you recorded, like "where in the recording did I open the billing page?"

This works for the recording you're working on. There isn't a search across all your past recordings yet.

Common questions#

Why did macOS ask for Screen Recording permission again?

HQ Capture is built on your Mac, so after a pack update macOS can treat it as a new app. Approve it again.

Does it record my camera and microphone?

Only if you want it to. It records screen, camera, and narration as separate layers, and you can turn the camera and mic off.

Does it run on Windows or an Intel Mac?

No. It needs a Mac with Apple Silicon and macOS 26 or later.

Can my teammates see my recordings?

Not until you ask HQ to upload a recording to the company's files. After that, it follows the company's normal permissions.

If you get stuck#

If the install fails, check that Apple's Command Line Tools are installed and that you're on macOS 26 or later, then run the install again. If it still fails, run the install command again to update HQ Capture. If that doesn't fix it, update the Command Line Tools in System Settings, then General, then Software Update. If /record-process is missing after installing, start a new session. Still stuck? See The "I'm Stuck" Guide, or report it with /hq-bug.