Your first async video recording

Time: 5 minutes. You'll need: a modern browser (Chrome, Firefox, Safari 15+, Edge), a working webcam or the ability to share a screen, and any task or wiki page you can comment on.

By the end you'll have a short screen or webcam clip embedded in a task comment, playable inline for anyone with access, with no third party in the loop.

1. Open the task you want to comment on

From the tracker, open a task where you want to leave an async walkthrough (a bug repro, a design review take, a "here is what I mean" clarification). Click into the comment box at the bottom of the task.

2. Start the recorder

Two ways to start:

From the toolbar. Click the Video icon in the comment editor toolbar. The mode-picker modal opens.
From the keyboard. Press Cmd+Shift+R (macOS) or Ctrl+Shift+R (Windows / Linux). Works from any page in the app, whether or not you have an editor open.

3. Pick a mode and grant permission

The modal offers two options:

Camera + mic: your webcam plus your microphone.
Screen + mic: any window or the whole desktop, plus your microphone.

First time only, the browser asks you to grant camera and microphone (or screen-share) permission. Click Allow. Then click Start.

The mode-picker modal closes and a floating recorder pill appears at the bottom-right of the app, showing the elapsed timer and a Stop button.

4. Record, and navigate freely

Talk through whatever you wanted to show. Navigate anywhere in the app while you're recording: open a different task to reference the repro, jump to the wiki, switch projects. The floating pill stays visible and the recording keeps going. You can stop from anywhere with a Stop click on the pill, or by pressing Cmd+Shift+S.

Recordings cap at 10 minutes per clip. For longer explanations, split into two.

5. Let it upload

The pill flips to an upload state with a progress bar. When the upload finishes, the video inserts as an inline <video> element in the comment where you started. If you navigated away from the source editor before stopping, a toast appears with a Copy URL button so you can paste the video embed wherever you want.

Click Comment to post it. Anyone with access to the task plays the video inline, no external service, no Loom link.

What next

Async video: storage location, format choices, playback contract, and what is not in v1 (chapters, transcript search, timecode-pinned comments).
Huddles: the live-video sibling. Async video and huddles share the same object store and playback path.