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

# iPhone App

> A narrated video tutorial: pair the Enconvo iPhone app with your Mac and reach your chats from your phone.

export const YouTubePlayer = ({videoId, title = "Video"}) => <Frame>
    <div id={`youtube-player-${videoId}`} style={{
  position: "relative",
  width: "100%",
  paddingBottom: "56.25%",
  borderRadius: "12px",
  overflow: "hidden",
  cursor: "pointer"
}} onClick={() => {
  const container = document.getElementById(`youtube-player-${videoId}`);
  container.innerHTML = `<iframe style="position:absolute;top:0;left:0;width:100%;height:100%;border:none;border-radius:12px" src="https://www.youtube.com/embed/${videoId}?autoplay=1" title="${title}" allow="accelerometer;autoplay;clipboard-write;encrypted-media;gyroscope;picture-in-picture" allowfullscreen></iframe>`;
}}>
      <img src={`https://img.youtube.com/vi/${videoId}/maxresdefault.jpg`} alt={title} style={{
  position: "absolute",
  top: 0,
  left: 0,
  width: "100%",
  height: "100%",
  objectFit: "cover"
}} />
      <div style={{
  position: "absolute",
  top: "50%",
  left: "50%",
  transform: "translate(-50%, -50%)",
  width: "68px",
  height: "48px",
  backgroundColor: "rgba(255, 0, 0, 0.9)",
  borderRadius: "14px",
  display: "flex",
  alignItems: "center",
  justifyContent: "center"
}}>
        <svg width="24" height="24" viewBox="0 0 24 24" fill="white">
          <path d="M8 5v14l11-7z" />
        </svg>
      </div>
    </div>
  </Frame>;

The Enconvo iPhone app pairs with your Mac, so your Mac's projects and chats are on your phone. Every chat you open from the phone keeps running on your Mac, with its files, apps, and agents. This tutorial pairs a phone from start to finish: sign in, show the pairing code on the Mac, and scan it with the iPhone.

<YouTubePlayer videoId="rYhgz_SjnNs" title="How to Pair Your iPhone with Your Mac in Enconvo | Step-by-Step Tutorial" />

The video is 1 minute 12 seconds long. The written steps below follow the same order, with the matching timestamp for each step.

<Note>
  The iPhone app is in beta. Install it from [TestFlight](https://testflight.apple.com/join/MJQuEN28), or scan the TestFlight code in **Settings → Agents → Connections** on your Mac. Pairing needs Enconvo 2.5.6 beta or later on the Mac.
</Note>

## Steps

<Steps>
  <Step title="Sign in on your iPhone (0:07)">
    Install the iPhone app and sign in with the same Enconvo account as your Mac. Only phones signed in to your account can pair with it.
  </Step>

  <Step title="Show the pairing code (0:16)">
    On the Mac, open **Settings → Agents → Connections** and select **Show pairing code**. The QR code is good for five minutes; if it runs out, select **Show a new code**.
  </Step>

  <Step title="Scan it with your iPhone (0:22)">
    On the phone, open **Remote** and tap **Pair a Mac**, then point the camera at the code on your Mac. The two are paired in a moment. Your phone reaches the Mac through the Enconvo relay, and messages are end-to-end encrypted.
  </Step>

  <Step title="Your Mac, on your phone (0:34)">
    Once the Mac shows as **Online** in Remote, its projects and chats are right there on your phone.
  </Step>

  <Step title="Open any chat (0:40)">
    Open any chat and pick up where you left off. The chat still runs on your Mac, so it can use that Mac's files, apps, and agents.
  </Step>

  <Step title="Keep it reachable (0:47)">
    In **Connections**, turn on **Stay awake while charging**. It keeps the Mac from sleeping while it's plugged in, so your phone can always reach it. It has no effect on battery power.
  </Step>

  <Step title="Remove a phone (0:52)">
    Lost a phone? In **Connections → Paired phones**, select **Remove** next to it. That phone can no longer reach your Mac; to use it again, pair it with a new code.
  </Step>
</Steps>

## What you can do from your phone

Once paired, you can:

* Browse your Mac's projects and chats, and continue any chat.
* Answer questions an Agent asks while it works on your Mac.
* Get notified when a chat finishes.
* Chat with AI models on the phone itself, using Enconvo Cloud points or your own API key.

## Manage paired phones

**Settings → Agents → Connections** lists every paired phone and shows whether phones can reach this Mac right now.

| Task               | How                                                                                                                                 |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| Pair another phone | Select **Pair another phone** and scan the new code. A Mac can have up to 10 paired phones.                                         |
| Remove a phone     | Select **Remove** next to it in **Paired phones**.                                                                                  |
| Start over         | Select **Reset connection**. Enconvo creates a new connection key and removes every paired phone; each phone then scans a new code. |

<Tip>
  If the phone can't reach your Mac, check that the Mac is awake, signed in, and online, and that **Connections** shows it as **Online**.
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Chat" icon="comments" href="/ai/chat">Chats, models, and the Chat Window you continue from the phone.</Card>
  <Card title="Agents" icon="robot" href="/ai/agents">The Agents your phone can hand work to on the Mac.</Card>
  <Card title="Messaging Channels" icon="paper-plane" href="/integrations/messaging">Reach an Agent from Telegram or Discord instead.</Card>
  <Card title="Account" icon="user" href="/configuration/account">Sign in and manage the account both devices share.</Card>
</CardGroup>