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

# Using Companion

> Ask Chief about your screen, collect notes and screenshots with Quick Capture, and hand your work to an app, teammate, or AI agent.

**Companion** lets you ask Chief about the app in front of you and collect spoken or typed notes and screenshots without starting a [Live Session](https://docs.chief.bot/help/meetings-live-sessions/starting-a-live-session.md). You can paste a capture into another app, send it to an AI agent, or share it with a secret link.

Companion runs in the [Chief desktop app](https://docs.chief.bot/help/meetings-live-sessions/installing-the-chief-desktop-app.md) on Mac and Windows. What you ask appears under **Companion** in the sidebar and is private to you.

## Use Companion

![Chief - a shared Quick Capture page with spoken notes, screenshots, and Markdown controls](https://mintcdn.com/chief-2d405d1a/Wmne78MJS3s-U7OW/images/help/companion-quick-capture-shared-link.png?fit=max\&auto=format\&n=Wmne78MJS3s-U7OW\&q=85\&s=0ad34bf44fead17a4d7810d7e407035c)

You need the desktop app [paired with your account](https://docs.chief.bot/help/meetings-live-sessions/pairing-managing-devices-updating-the-app.md). Open **Companion** from the app sidebar. You can also use the configured quick-bar shortcut, click the crown-shaped Companion button at the edge of your screen, or use the Chief menu bar or system-tray icon.

### Ask Chief about your screen

Companion has three ways to ask from any app:

* Use **Capture area** or **Capture full screen**, then ask about the screenshot.
* Open the quick bar, type your question, and send it.
* Hold the talk shortcut while you ask out loud, then release it. Double-tap the talk shortcut for hands-free listening.

Chief answers with what it knows about the selected Project. In **Settings** › **Companion** › **Project**, choose whether Companion uses your last-used Project, your default Project, or one you pin. The picker in Companion can change the Project for that panel.

When **Send what you're working in** is on, Chief can include the app, window title, and page in front of you. This setting needs Accessibility access. Asking out loud uses your microphone; it does not use your computer's audio.

On Mac, allow **Screen Recording** for screenshots and current-window context, **Microphone** for voice, and **Input Monitoring** when the selected talk key requires it. Chief may ask you to restart after you grant Screen Recording or Input Monitoring. On Windows, use the link in Companion to open microphone privacy settings when needed.

### Collect notes and screenshots with Quick Capture

In the Companion panel, click **Capture thoughts**. A Quick Capture keeps your entries in the order you add them:

* Hold the talk shortcut while you speak, or double-tap it for hands-free recording. Chief adds the transcript to the capture.
* Use the capture-area or full-screen shortcut to add a screenshot.
* Type into the open capture when you want to add written context.

Turn on **Hear your computer too** under **Settings** › **Companion** › **Captures** when a spoken capture should include system audio, such as the other side of a call. Chief labels who said what. Turn it off while music or a video plays. This setting does not change what Companion hears when you ask Chief a voice question.

Open a capture to rename it, review its entries, preview screenshots, reopen it in the quick bar, or delete it. You can also **Copy folder path**, **Open folder**, **Share ZIP**, or **Send to AI**.

### Paste only your latest feedback

Use the paste shortcut while a capture is open to paste its new entries into the app where you are working. After a successful paste, the next paste includes only entries added since the previous one. You can also open the capture and choose **Copy as Markdown**.

In **Settings** › **Companion** › **Captures**, **Automatically paste where I was typing** can paste a finished spoken capture back into the text field you were using when that app is in front again.

### Share a capture by secret link

Create a secret link when you want to send the capture to a teammate, a ticket, or an AI agent. Anyone with the link can read its typed, spoken, and screenshot entries in a browser, copy them as Markdown, or download the Markdown. The page updates when you add more to the shared capture.

The capture's **Copy link** button creates a link the first time you use it. Turn off the link to revoke access. Deleting the capture also turns off its link, and deletion cannot be undone.

**Auto-copy links for new captures** can create and copy a link when the first words or screenshot arrive and again when a hands-free recording stops. It replaces the current clipboard contents, but does not replace them in the middle of a paste.

> [!WARNING]
>
> ⚠️ **Important:** A secret link does not require a Chief account. Share it only with people who should see the capture, just as you would with a [Reader link to a Live Session](https://docs.chief.bot/help/meetings-live-sessions/sharing-joining-a-live-session.md).

### Sync captures and control privacy

Captures are saved on the device that made them. On Mac, Chief also saves them to your account so they appear on every Mac where you sign in. The **Saved to your account** row shows the last sync time or explains why the last attempt failed.

Captures remain private until you copy, paste, send, or share them. Chief transcribes spoken notes in the cloud. Password managers, private browser windows, and secure fields are never read automatically, but a screenshot you take yourself can still include sensitive information.

In **Settings** › **Companion**, you can also:

* Turn **Use Companion** off without disabling Live Sessions or Tasks.
* Show or hide the Companion button, move it to the left, right, or bottom edge, or hide it for one hour.
* Choose whether spoken questions show your words while you talk.
* Change the Companion shortcuts by clicking a shortcut where it appears.

## FAQ

> [accordion] What's the difference between Companion and a Live Session?
>
> Companion helps you ask about the app in front of you or collect a focused set of notes and screenshots. It does not require a Live Session. Use a Live Session when you want Chief to capture and organize an ongoing meeting.

> [accordion] Why did a second paste include only part of my capture?
>
> After a capture is pasted successfully, Chief marks those entries as handed off. The next paste contains only entries you added afterward.

> [accordion] Does a shared capture link update?
>
> Yes. The secret link shows the capture as it exists now and updates as you add entries. Turn off the link when you no longer want anyone with it to have access.

> [accordion] Where are my captures on another computer?
>
> Captures sync across Macs signed in to the same Chief account. Check **Settings** › **Companion** › **Captures** for the sync status. Cross-device capture sync currently covers Macs.

> [accordion] Why can't Companion capture my screen or hear me?
>
> Open Companion and complete the permission shown there. On Mac, screenshots and current-window context need **Screen Recording**, voice needs **Microphone**, and some talk keys need **Input Monitoring**. Restart Chief when the permission card asks you to.

> [accordion] Can I turn Companion off without turning off Live Sessions?
>
> Yes. Turn off **Use Companion** in **Settings** › **Companion**. Companion shortcuts, menu items, and suggestions go away, while Live Sessions and Tasks keep working.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.