Quickstart: your first remote coding session in five steps

Set up OpenCode, Codex, or Cursor with Sesori in five steps and send your first prompt from your phone.

Five steps to your first remote coding session.

New to the terminal? A couple of these steps need you to run commands in your laptop's Terminal app. If that sounds new, ask a developer friend or reach out to us — we'll help you get set up.

Before you start

You'll need:

• An account to sign in to Sesori. GitHub is recommended — see step 3.
• A laptop or desktop where you can run terminal commands.
• A subscription or API key for the assistant you pick in step 1.

1. Install an AI coding assistant

The assistant is the engine that does the coding work on your machine. Sesori connects to it. Sesori supports OpenCode, Codex, and Cursor today, with Claude Code coming soon.

Pick the one you want — you only need one, and you can add others later.

OpenCode

On Windows, use WSL. Install OpenCode inside your WSL terminal, then run the rest of this guide in that same WSL terminal — including installing and running sesori-bridge.

curl -fsSL https://opencode.ai/install | bash

Then connect an AI provider:

opencode auth login

OpenCode supports most popular options, including GPT subscriptions, KimiCode, Google Gemini, and Anthropic API keys. If you don't have a subscription yet, we recommend starting with OpenAI ($20/month) or OpenCode Go ($5 first month, $10 thereafter).

Confirm it's installed:

opencode -v

Codex

On macOS and Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

On Windows (native — WSL is not required):

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Then sign in with your ChatGPT account:

codex login

Confirm it's installed:

codex --version

Cursor

On macOS and Linux:

curl https://cursor.com/install -fsS | bash

On Windows:

irm 'https://cursor.com/install?win32=true' | iex

Then sign in:

cursor-agent login

Confirm it's installed and signed in:

cursor-agent status

More details: Prerequisites

2. Install the Sesori Bridge

The Sesori Bridge is a small command-line tool that connects the Sesori app to your assistant. Pick the tab for your operating system:

macOS / Linux

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

Windows

Run this in PowerShell:

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

Windows PATH. The installer adds sesori-bridge to your PATH and refreshes the current PowerShell session, so the next step usually works right away. If sesori-bridge returns "command not found", open a new PowerShell window — or refresh PATH in this one:

$env:Path = [Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [Environment]::GetEnvironmentVariable("Path","User")

More details: Set Up Sesori

3. Start the Bridge and sign in

Run the Bridge in your terminal:

sesori-bridge

You'll be asked to pick a sign-in method, then your browser opens to finish signing in. We recommend GitHub — other options are currently under development and may not work as expected.

Remember which method you picked. You'll need to sign in to the app with the same one in step 5, or the relay can't match the app to your machine.

The Bridge detects the assistants installed on your machine and starts the one you're using, so everything you do happens through the Sesori app on your phone.

Keep this terminal window open. Because everything is end-to-end encrypted and runs locally on your machine, your phone can only connect while your desktop is running and sesori-bridge is active in a terminal window. If you close the terminal, the connection is lost — just run sesori-bridge again to reconnect.

Want to use the OpenCode web interface alongside Sesori? You can run both in sync. Start the OpenCode web interface first:

opencode web

Note the port it prints (for example, 4096). Then start the Bridge against that same server with auto-start disabled:

sesori-bridge --opencode-no-auto-start --opencode-port 4096

Replace 4096 with the port OpenCode web is using. --opencode-no-auto-start always needs --opencode-port alongside it. With this setup, Sesori and OpenCode web stay fully in sync — what you see in one shows up in the other.

Enable workspaces in the OpenCode web interface so both surfaces share the same sessions and project state. See Connect to an existing OpenCode server for the full walkthrough.

4. Install Sesori on your phone

iPhone: Install Sesori from the App Store.

Android: Install Sesori from Google Play.

More details: Install the App

5. Open Sesori and connect

Open the Sesori app and sign in with the same account and sign-in method you used for the Bridge in step 3. If the Bridge is running on your machine, Sesori takes you straight to your project list.

More details: Connect the App

That's it

Tap a project, create or open a session, and send a prompt. You can type, use voice input, choose an agent/model, answer pending questions, and stop a running task from Sesori.

If you have more than one assistant installed, pick which one a session runs on from the Coding tool selector when you create it.

Stuck? Check Troubleshooting — most setup issues have a known answer.