> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tuple.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Capturing calls

<View title="macOS" icon="apple">
  <Warning>
    Tuple's local Capture feature is in **alpha**. Aspects of the feature might change as we continue to iterate on feedback.
  </Warning>

  Capture streams what happens on a call to your **local disk**: a transcript of what's said, recordings of any screen that gets shared, and metadata for apps on shared screens. It runs **entirely on your machine**; nothing gets sent to an external service.

  Capturing calls enables two things: it lets agents follow the call in real time, and allows you to reference information from past calls.

  ## Starting and stopping capture

  The **Capture** button appears in the popover, the screen share window, and the webcam window:

  <img src="https://mintcdn.com/tuple-0f82e5be/vsNbq2Hy43onmJQm/images/pairing-with-tuple/capture/capture-screen-share-window.png?fit=max&auto=format&n=vsNbq2Hy43onmJQm&q=85&s=ebadfdaaffe4d1ef00d1c1761ff8ffbe" alt="The Capture button in the screen share window toolbar on macOS" width="3044" height="2218" data-path="images/pairing-with-tuple/capture/capture-screen-share-window.png" />

  <img src="https://mintcdn.com/tuple-0f82e5be/vsNbq2Hy43onmJQm/images/pairing-with-tuple/capture/capture-webcam-window.png?fit=max&auto=format&n=vsNbq2Hy43onmJQm&q=85&s=acf5f0e65c1a9f95e5de071c66562dac" alt="The Capture button in the webcam window on macOS" width="1774" height="1434" data-path="images/pairing-with-tuple/capture/capture-webcam-window.png" />

  <img src="https://mintcdn.com/tuple-0f82e5be/vsNbq2Hy43onmJQm/images/pairing-with-tuple/capture/capture-popover-control.png?fit=max&auto=format&n=vsNbq2Hy43onmJQm&q=85&s=3873485728553a56adb42b138d0bd3a9" alt="The Capture button in the popover call controls on macOS" width="1136" height="1256" data-path="images/pairing-with-tuple/capture/capture-popover-control.png" />

  When the popover is focused during a call, **C** toggles capture. See [Using your keyboard to navigate Tuple](/pairing-with-tuple/using-your-keyboard-to-navigate-tuple).

  You can also have Tuple start capturing as soon as you join any call; see [Start capture automatically](/application-preferences/macos-preferences-capture#start-capture-automatically).

  ## What Capture records

  A captured call contains three kinds of content:

  * **Transcript**: everything said on a call, transcribed by a local Whisper model.
  * **Screen recordings**: recordings of any screen that gets shared on a call (yours or someone else's).
  * **App metadata**: window titles and content URLs for the apps visible in shared screens; learn more about [what gets shared](/pairing-with-tuple/sharing-app-metadata).

  ## Notifying other participants

  When you start capturing, every other participant receives a notification letting them know. The notice stays on screen until the participant acknowledges it or leaves the call. If you join a call that's already being captured, you'll receive the same notification.

  While capture is active, each capturing participant shows a **Capturing** indicator in the popover participant list and in the screen share window's participant list.

  ### Capturing solo

  You can capture a call by yourself, even before any other participants have joined. This is useful for capturing notes, dictation, or working with an agent (see [Connecting an agent](/cli/connect)).

  ## The Capture menu

  The chevron next to the **Capture** button opens the Capture menu, which shows what's being captured right now and how to hand the call to an agent:

  <img src="https://mintcdn.com/tuple-0f82e5be/SIc2aLyZ7GDfVM3L/images/pairing-with-tuple/capture/capture-menu.png?fit=max&auto=format&n=SIc2aLyZ7GDfVM3L&q=85&s=78f6f33ca1ed27087a90970da58625e3" alt="Capture menu" width="1732" height="1492" data-path="images/pairing-with-tuple/capture/capture-menu.png" />

  The top of the menu is a live status block showing what's being captured (transcript, screen recordings, and app metadata). Each row has a status dot that dims when that kind of content isn't being collected.

  Below the status block, **Connect a Local Agent** allows you to copy commands to hand the live call to an agent:

  * **Copy Terminal Command** copies a [`tuple connect`](/cli/connect) command to run in your terminal.
  * **Copy Agent Prompt** copies a prompt to paste into an agent you already have running.

  Copying a command or prompt provides context. Ask the agent explicitly when you want it to follow the call continuously. For existing scripts or skills, use the [migration guide](/cli/migration).

  ## Accessing captured calls

  Captured call content is stored in a local database on your machine. You can browse captured calls in the [Local History](/pairing-with-tuple/local-call-history) tab, or use the `tuple` CLI to search, list, and export past calls — see [Searching past calls](/pairing-with-tuple/searching-past-calls).

  ## Automating with triggers

  Tuple fires `call-capture-started` and `call-capture-complete` [triggers](/triggers/api-reference) when a capture session begins and ends. Use a trigger script to post-process transcripts, summarize the call, or save it into your team's notes system.

  Browse the [Triggers Directory](https://tuple.app/triggers/directory?event=call-capture-started\&event=call-capture-complete) to see what others have built.
</View>
