> For the complete documentation index, see [llms.txt](https://docs.sesori.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sesori.com/setup/set-up-the-bridge.md).

# Install and start the Bridge

The Sesori Bridge runs beside your code and AI coding assistants. It connects them to the mobile app through the encrypted relay.

## 1. Install

{% tabs %}
{% tab title="macOS or Linux" %}

```bash
curl -fsSL https://sesori.com/install.sh | bash
```

The Bridge is installed under `~/.local/share/sesori/`, with a launcher in `~/.local/bin/`.
{% endtab %}

{% tab title="Windows" %}
Open PowerShell and run:

```powershell
irm https://sesori.com/install.ps1 | iex
```

The Bridge is installed under `%LOCALAPPDATA%\sesori\`.
{% endtab %}
{% endtabs %}

### Install with npm

If Node.js is installed, this command installs or refreshes the Bridge:

```bash
npx @sesori/bridge
```

`npx @sesori/bridge` installs the Bridge but does not start it. Use `sesori-bridge` after it finishes.

## 2. Start and sign in

```bash
sesori-bridge
```

On first run, choose GitHub, Google, Apple, or email sign-in. OAuth options open or print a browser URL; email sign-in continues in the terminal. The Bridge then registers with the relay, checks the assistants on this computer, and waits for the app.

If a newly installed command is not found, open a new terminal. On Windows, you can run the managed executable directly:

```powershell
& "$env:LOCALAPPDATA\sesori\bin\sesori-bridge.exe"
```

## 3. Keep it running

The Bridge must remain running, and the computer must remain awake and online, for remote sessions to work. It prevents ordinary idle sleep by default while running, but closing a laptop lid can still put the machine to sleep.

Press `Ctrl+C` to stop the Bridge cleanly.

## 4. Check the connection

Open Sesori and sign in with the same account. The Bridge indicator turns green when the app can reach it. If it remains offline, use [Troubleshooting](/help/troubleshooting.md).

## Updates

Managed installs check for updates at startup and every four hours while running. A newly discovered update is applied after the Bridge restarts. You can check immediately with:

```bash
sesori-bridge update
```

Use `sesori-bridge update --force` only when the updater tells you to force an available update. See [Bridge CLI reference](/setup/bridge-cli.md) for configuration and recovery commands.

## Next

👉 [Connect the app and Bridge](/setup/connect-the-app.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sesori.com/setup/set-up-the-bridge.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.