Recording Sessions

taiku treats recordings as collaboration tools, not just local convenience features. Recordings capture exactly what happened in a session and produce shareable artifacts.

Recording a session

taiku supports two recording modes: window recording and tile recording. Both produce video files that can be browsed, renamed, and downloaded from the recording gallery.

Window recording

Window recording captures the entire taiku window or browser tab. This is the right choice when you want a complete record of a session, including workspace layout, toolbar interactions, and panel overlays.

To start a window recording:

1. Open the command palette with Cmd+K (or Ctrl+K).
2. Select "Start Window Recording".
3. In the browser, a system dialog appears asking you to choose which tab or window to share. Select the tab running your taiku session. In the desktop app, capture starts immediately with no prompt.
4. A recording indicator appears in the session UI. The timer shows elapsed time, and you can pause or stop from the command palette at any time.

Tile recording

Tile recording captures a specific region of the workspace, such as a terminal, a peek panel, a tunnel view, or any tiled area. This is useful when you want a focused artifact of one particular workflow without the noise of the full session UI.

To start a tile recording:

1. Open the command palette and select "Start Tile Recording".
2. Click on the tile you want to record. The selected tile (and any tiles nested within it if it has been split) gets a visual highlight showing the capture region.
3. Recording starts, capturing only the pixels within that tile's bounding box.

If you resize the recorded tile during capture, the recording region follows the new geometry.

You can pause, resume, and stop recordings from the command palette at any time. Paused time is tracked separately so the final recording reflects actual content duration.

Browser vs. desktop

In the browser, recording uses getDisplayMedia and prompts you to select a tab. The desktop app uses native screen capture via Tauri, with no selection dialog and faster startup.

The recording gallery

Recordings appear in the gallery after capture, but the storage model depends on where you recorded them.

• In the browser, recordings are uploaded to the session and appear in the shared gallery for participants.
• In the desktop app, recordings are stored locally on disk and the gallery shows that device's local files.

So recordings can be collaborative artifacts, but desktop recordings are not automatically shared with every participant.