Prerequisites: install OpenCode, Codex, or Cursor

Install OpenCode, Codex, or Cursor and verify it runs locally before connecting Sesori. Claude Code support is coming soon.

Sesori controls an AI coding assistant from another screen. Before you set up Sesori, make sure that assistant works on your laptop or desktop.

Choose an assistant

Sesori works with three AI coding assistants today, with a fourth on the way:

Assistant	Command	Minimum version
OpenCode	opencode	1.14.0
Codex	codex	0.139.0
Cursor	cursor-agent	2026.07.16
Claude Code	—	Coming soon

Install at least one of the available ones and sign in to it. The Bridge detects which assistants are on your machine — you don't need to tell it which one you picked, and you don't need to run any extra Sesori commands to register them.

Claude Code support is coming. When it lands, it becomes available the same way as the rest: install it, and the Bridge picks it up.

You can install more than one. If several assistants are available, you choose which one a session runs on from the Sesori app. See Connect the App.

Install

OpenCode

On Windows, use WSL. Install OpenCode inside your WSL terminal, then keep using that same WSL terminal for the rest of the Sesori setup.

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

You can also install OpenCode with Node.js in that same environment:

npm install -g opencode-ai

Then connect an AI provider. OpenCode needs access to at least one provider before it can run useful sessions:

opencode auth login

OpenCode supports most popular options, including GPT subscriptions, KimiCode, Google Gemini, and Anthropic API keys.

Check it's ready:

opencode --help

Full docs: opencode.ai/docs

Codex

On macOS and Linux:

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

Codex is also available via npm (npm install -g @openai/codex) or Homebrew (brew install --cask codex).

On Windows, Codex installs natively — WSL is not required:

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

Then sign in:

codex login

This opens a browser flow to sign in with your ChatGPT account. You can also authenticate with an API key — see Codex authentication.

Check it's ready:

codex --version

Full docs: developers.openai.com/codex

Cursor

On macOS and Linux:

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

On Windows, Cursor CLI installs natively:

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

Then sign in:

cursor-agent login

Cursor must be signed in before the Bridge can use it. Unlike the other assistants, the Bridge checks Cursor's login state up front and reports Authentication required if you haven't logged in. You can also authenticate by setting a CURSOR_API_KEY environment variable.

Check it's ready:

cursor-agent status
cursor-agent --version

Cursor's own documentation refers to this tool as agent. The installer provides both names for the same program; Sesori looks for cursor-agent.

Full docs: cursor.com/docs/cli

Open a project

Your assistant can run inside a project folder, or outside any project at all.

Inside a project (most common — useful for working on an existing repo):

cd /path/to/your/project

Then start your assistant in that folder. Start or open a session once so there's some session history for Sesori to display.

You can also run outside any project, which is useful for kick-starting something new, or for generic conversations and tasks tied to your machine rather than a specific repo.

If the command isn't found

If your shell says command not found, restart your terminal or make sure the install location is in your PATH.

If an assistant is installed somewhere unusual, you can point the Bridge straight at it:

sesori-bridge --opencode-bin /path/to/opencode
sesori-bridge --codex-bin /path/to/codex
sesori-bridge --cursor-bin /path/to/cursor-agent

How the Bridge uses your assistant

When you run sesori-bridge, it detects the assistants installed on your machine, starts or connects to the one you're using, and connects Sesori to it. The Bridge handles the configuration for you — you don't need to manage anything by hand. In this mode, the Sesori app on your phone is your only interface.

Alternatively, if you'd like to use the OpenCode web interface alongside Sesori, you can start OpenCode yourself with opencode web and have the Bridge connect to it instead of starting its own. Both interfaces then stay fully in sync — what you do in one shows up in the other. Make sure to enable workspaces in the OpenCode web interface so both surfaces share the same sessions and project state. For detailed instructions, see Connect to an existing OpenCode server.

Next

Now that your assistant is ready, set up the Sesori components.

👉 Set Up Sesori