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

# Connect Life

> Pair Synheart Life with your organization so your coding agent can adapt to you, and keep it current

Synheart Life works out from your own state whether you're stretched or focused. Paired with your organization, it lets Synapse tell your coding agent how to work with you right now: keep it brief, take smaller steps, or go into full detail. The agent gets that instruction, never a score or any health data.

It's optional. Without Life, Synapse works for you as before, with no human state about you.

## Pair Life with your organization

About three minutes. You need a Synapse seat.

**1. Get Synheart Life**

Download it for macOS or Windows from [synheart.ai/products/life](https://synheart.ai/products/life) and sign in. Any Synheart account works; it doesn't have to be your work email.

**2. Turn on Cloud Upload**

In Life, open **Settings → Privacy** and turn on **Cloud Upload**. Pairing needs it, because Synapse reads your state from your personal Life account in the cloud.

**3. Create a pairing code in Synapse**

At [synapse.synheart.ai](https://synapse.synheart.ai), open **You → My connections**, find **Life by Synheart** and choose **Connect**, then **Create pairing code**. It works once and is valid for 15 minutes. Your admin can also send you an invite, which is valid for 7 days.

**4. Enter it in Life**

On the same computer, choose **Open Life**: Life opens with the code filled in, and you confirm. Or choose **Copy pairing link**, then in Life open **Settings → Membership → Connect your workplace**, paste the link and confirm. On a phone, scan the QR code with the Life app instead.

**Life Plus.** While you hold a Synapse seat, your organization provides Life Plus on your Life account. It turns on within a few seconds of pairing and stays as long as you have the seat. Disconnecting Life doesn't end it.

## Keep it current

Synapse uses only readings from the **last 2 hours**, and Life sends readings only while it's running. If Life has been closed, or your computer asleep, for more than 2 hours, your agent gets no adaptation until Life sends a new reading. It doesn't guess from older ones.

Under **You → My connections**, the **Life by Synheart** row shows your latest reading:

| You see | It means | Do this |
| - | - | - |
| Latest reading from Life 5m ago | Synapse has a current reading | Nothing |
| Latest reading from Life 3h ago, with a warning | Nothing in the last 2 hours, so no adaptation | Open Life and keep it running while you work |
| Synapse has no reading from Life in the last 30 days | Life hasn't sent anything | Check that Life is running and **Cloud Upload** is on |

A current reading doesn't always change how your agent works: when it's uncertain, or your organization is on Synapse Free, the agent responds as usual.

Your agent can tell you the same. When there's no instruction, Synapse's `human_state` tool returns `available: false` with a `reason`, such as `stale_state`. Signed in as yourself, `stale_state` also comes with `last_state_at`, the time of your newest reading.

## Two ways Life reaches your agent

Life can adapt your agent in two ways. Use either or both.

| | Connect Life (this page) | Connect with Life |
| - | - | - |
| What it does | Synapse adds the instruction to its own answers, and your state counts in your team's totals above the [cohort floor](https://docs.synheart.ai/synapse/team-views.md#the-cohort-floor) | Life hands the instruction straight to your agent on this computer |
| Goes through Synheart's servers | Yes: your personal Life account, read by your organization's Synapse | No: it stays on this computer |
| Turn it on | Pair Life with your organization, above | In Life, **Settings → AI & chat → Connect with Life**, then `synheart life connect --write` (add `--host cursor`, or `--host codex` with CLI 0.31.0 or later) |
| Check it | **You → My connections** | `synheart life status` |

## Disconnect

In Life, open **Settings → Membership** and choose **Disconnect**. Your readings stop counting towards your team's totals at once, and your agent stops getting instructions from Synapse. Life Plus stays while you hold a Synapse seat. To pair again, create a new pairing code.

## Troubleshooting

| Symptom | Fix |
| - | - |
| Life says *This needs Cloud Upload switched on first* | **Settings → Privacy → Cloud Upload** in Life, then paste the code again |
| *This pairing code has expired* or *has already been used* | Create a new one in **My connections**. A code you create works once, for 15 minutes; an invite from your admin lasts 7 days |
| Life says you need a Synapse seat | Ask your Synapse admin for a seat |
| Connected, but your agent never adapts | Check **My connections**. If the latest reading is more than 2 hours old, keep Life running. If the row says sharing is off, check your consent in Life and choose **Check consent again** under [Privacy & consent](https://docs.synheart.ai/synapse/privacy-and-consent.md) |
| Life Plus didn't turn on | Restart Life. If it's still off, contact support with the time you paired |


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