Extension · v0.2.17

Cepho Sync

Cepho syncs your Cursor/VS Code project to the cloud so you can keep working from your phone — chat with AI about your code, read and edit files, and stay on top of your project whether your PC is on or off.

Set it up once — the rest runs automatically.

↓ Download cepho-0.2.17.vsix 13 MB · bundled daemon · recommended

Cepho Sync is not searchable in Cursor's extension marketplace yet. Install via the terminal command in Step 2 (fastest) or download the .vsix and use Install from VSIX in Cursor (Ctrl+Shift+P).

Using Visual Studio (not VS Code/Cursor)? The file may open in the wrong app — install via the terminal command in Step 2 instead, or use Install from VSIX directly in Cursor/VS Code.

↓ Download .env.cepho.example Firebase client config

Setup

Step 1 — Create your Cepho account

  1. Download the Cepho app on your phone
  2. Create an account with email + password
    (signed up on the waitlist? Log in with the same email — your founder benefits activate automatically)

Step 2 — Install the Cepho extension in Cursor

Option A — Terminal (recommended)

Windows (PowerShell):

PowerShell 
iwr https://cepho.cloud/downloads/cepho-0.2.17.vsix -OutFile $env:TEMP\cepho.vsix; cursor --install-extension $env:TEMP\cepho.vsix --force

macOS/Linux:

bash 
curl -L -o /tmp/cepho.vsix https://cepho.cloud/downloads/cepho-0.2.17.vsix && cursor --install-extension /tmp/cepho.vsix --force

Using VS Code instead of Cursor? Replace cursor with code in the command above.

After install: run Developer: Reload Window via Ctrl+Shift+P.

Option B — Manual VSIX (alternative)

  1. Download cepho-0.2.17.vsix using the button above
  2. In Cursor: press Ctrl+Shift+P
  3. Type Extensions: Install from VSIX... and select it
  4. Find the downloaded .vsix file and confirm

After install: run Developer: Reload Window via Ctrl+Shift+P.

Step 3 — Open your project

Open the project folder in Cursor that you want to sync with Cepho. It should be a folder you already work in — Cepho connects to an existing project, not an empty template.

Step 4 — Add your .env file

The Cepho extension needs to know which cloud project it talks to. That happens via a small config file in your project folder.

  1. Download .env.cepho.example using the button above
  2. Place it in the root of your project folder
  3. Rename it to .env (or add the contents to an existing .env file you already have)
Is it safe? Yes. The file only contains public Firebase project info — the same type of information that is already public in any Firebase app. It contains no passwords or secrets, and it is never uploaded to the cloud with the rest of your project.

Step 5 — Connect Cursor to your Cepho account

  1. Press Ctrl+Shift+P in Cursor
  2. Type Cepho: Connect to Cepho and select it
  3. Enter your Cepho app email
    (it does not need to be the same email as your Cursor account — Cepho connects via email, not login provider)
  4. You will now see Cepho: Awaiting approval… in the status bar

Step 6 — Approve the connection in the app

  1. Open the Cepho app on your phone
  2. Tap the menu (☰) → IDE Connections
  3. Under Pending approval you will find your Cursor connection
  4. Tap Approve

The status bar in Cursor will now show Cepho: Connected ✓.

Step 7 — Install background sync

  1. Press Ctrl+Shift+P in Cursor
  2. Type Cepho: Install background daemon and select it
  3. Wait a few seconds while it sets up

This is the last technical step — it runs in the background from now on, even when you restart Cursor.

Step 8 — You're all set

  • Status bar in Cursor: Cepho: Synced ✓
  • Cepho app: Synced ✓ + time of last sync

Your files now sync automatically whenever you save. Open the Cepho app, select your project, and start a chat — Cepho already knows your code.

Connect with a different email than your Cursor account

You do not need to use the same email in Cursor and in the Cepho app.

Note: For app-initiated connections, the Cursor user must have opened the Cepho extension at least once before, so their email is registered in the system.

Troubleshooting
Problem Solution
"Build the daemon first" error You are using an older extension version. Download the latest .vsix (v0.2.17) from cepho.cloud/extension and reinstall via the terminal command or Install from VSIX
"Missing .env" error Check that the .env file is in the root of the project folder, not in a subfolder
Connection stays "Awaiting approval" Make sure you approved in the app under IDE Connections — not just opened the app
No files in the app after sync Wait up to 60 seconds — the first sync takes a little longer than subsequent ones
"No Cepho account found with that email" That person must create a Cepho app account first before you can invite them via email