Skip to content

Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.

9.3 KB
Raw Blame
Codync has three parts that update separately: the desktop app, the host that runs your bots, and the iPhone app. On macOS and Windows the host ships inside the desktop app and updates with it. On Linux, and on any computer where you installed only the host, the host updates on its own. The iPhone app comes from the App Store.

## The desktop app

The desktop app checks for a new release every day, downloads it, and installs it when you're not using the computer. Both are on by default.

You'll find the update settings in two places:

- **Settings → Updates** in the chat window.
- **Settings → Updates** in the menu bar (macOS) or tray (Windows, Linux) menu.

Both offer the same controls:

| Control | What it does |
| --- | --- |
| **Check for updates** | Checks now. When a release is found, the button reads **Update to** and the version; choose it to download. When you already have the newest version, a dialog says so. |
| **Restart to update** | Appears once the release is downloaded. Restarts Codync into the new version. |
| **Automatically check for updates** | The daily check. |
| **Automatically download and install** | Downloads releases on its own and installs them when Codync is idle. |

While a release is available, an **Update** button also appears in the chat window's sidebar. One click downloads it (a ring shows the progress, and Codync stays usable) and restarts into it.

A finished download never quits the app by itself. Automatic installation waits until no Codync window is in front, you haven't used the keyboard or mouse for ten minutes, and no bot is working. A downloaded update also installs when you quit Codync.

The exception is **Update now** chosen for this computer on another device (see [below](#when-the-phone-and-computer-versions-dont-match)): the app then downloads the release, even with automatic download off, and restarts into it in the background as soon as no bot is working, without waiting for you to step away.

On macOS and Windows, updating the app also updates this computer's host: the app stops the host, installs, and starts the new one. If you installed the Mac app with Homebrew, it still updates itself this way.

## The host on its own

On Linux, and on a Mac or server where you installed only `codync-host`, the host updates separately from any app.

- **Installed with the install script** and running as the background service: the host updates itself. It checks once a day while no bot is working, checks that the download is signed, and keeps your data. If the new version doesn't start, it puts the previous one back.
- **Installed with Homebrew:** run `brew upgrade leepokai/codync/codync-host`, then `codync-host install`.
- **Re-running the install script** also upgrades the host and restarts its service.

To check or update by hand:

```sh
codync-host update --check     # is there a newer release?
codync-host update             # install it now
codync-host update --status    # progress of an update
codync-host update --auto off  # turn automatic updates off (on to turn them back on)
```

A manual update won't interrupt a bot that's working unless you add `--force`; interrupted bots pick up their sessions again. In the terminal UI, press `^k` and choose **Check for updates**.

## A computer's version and its update

On the iPhone, tap the connection status at the top of the Bots tab (such as **1 connected**), choose **Manage computers**, and look at **Codync** at the bottom of the computer's card. It shows the version that computer runs, and says **Up to date** or which newer version is available. Tap **Update** to have the computer download it and restart into it, usually within a few minutes; the row says it's updating until the computer is back. While it restarts, the computer reads **Updating…** instead of offline, and its card doesn't ask for access. It's the same update as **Update now** on the notice [below](#when-the-phone-and-computer-versions-dont-match), with the same rules: a computer doesn't update while a bot is working on it, and a Mac or Windows computer updates this way while the Codync app is open on it. When the computer can't be updated from your phone, the row says how to do it there.

A Windows computer shows only its version there, with **Update** only when this app needs a newer Codync; otherwise it updates with its desktop app. A host installed with Homebrew also shows only its version: update it with `brew` ([above](#the-host-on-its-own)).

**Desktop:** **Settings → Computers** shows the same **Codync** row on the card of each computer you reach over SSH, and on Linux on this computer's card too. On macOS and Windows this computer's Codync is the desktop app itself, updated from **Settings → Updates**.

## The iPhone app

The iPhone app updates through the App Store. Every iPhone release goes through Apple's App Review first, so the App Store version can be a day or more behind the desktop app and the host. When a newer version is out, a card at the top of the bot list tells you which version is available, with an **Update** button that opens the App Store. You can dismiss it.

Your computer accounts for the review delay: a computer update that needs a newer iPhone app isn't offered to computers until that iPhone version is in the App Store.

## When the phone and computer versions don't match

Each side knows the oldest version of the other side it still works with. When one side is too old, you see a notice above that computer's bots and in place of the message box, and the computer's status reads **Needs update**. Your chats stay safe on the computer, and drafts are kept. Once the older side is updated, the notice goes away on its own.

| Notice | What to do |
| --- | --- |
| **Update this app** | The app you're using is too old for that computer. On the iPhone, **Update Codync** opens the App Store; if the version you need is still in App Store review, the button stays greyed out until it's available. In the desktop app, use the update button on the notice. |
| **Update Codync on** and the computer's name | The computer's host is too old for this app. Choose **Update now** on the notice: the computer downloads the new version and restarts into it, usually within a few minutes, and the notice goes away once it's back. A computer doesn't update while a bot is working on it; the notice then says so, and you can try again when the bot is done. A Mac or Windows computer updates this way while the Codync app is open on it. When the computer can't be updated from another device (the app isn't open there, or its Codync is older), the notice says how to do it there: on a Mac, open Codync and check for updates; on Linux, run `codync-host update`. |

In the terminal UI, the status line shows **needs update** with the reason, and sending is blocked until you update.

## If an update fails

1. Quit Codync completely (on macOS, **Codync → Quit Codync**, not just the window's close button) and open it again. A downloaded update may finish installing when the old app exits. Check the version in **Settings → Updates**.
2. If it still fails, reinstall the app from the [latest release](https://github.com/leepokai/Codync/releases/latest) and keep your data.

To reinstall the Mac app:

```sh
# 1. Quit Codync, then remove its background host service (your bots and keys stay):
/Applications/Codync.app/Contents/Resources/codync-host uninstall
# 2. Move Codync.app to the Trash, then install the new one from codync-macos.dmg.
# 3. Open Codync. It sets up the host again. If the host stays stopped:
/Applications/Codync.app/Contents/Resources/codync-host install
```

With Homebrew, quit Codync and run `brew reinstall --cask leepokai/codync/codync`. On Linux, replace the app the way you installed it, and update the host with `codync-host update`.

> **Note:** Don't use **Reset all data…**, delete `~/.codync`, or run a cleanup tool to fix an update. Those erase your bots and the computer's identity, and every phone has to pair again.

## Uninstalling

### On a computer

1. Remove the background host service: in the menu bar or tray menu choose **Settings → Uninstall host service**, or run `codync-host uninstall`. This keeps your data.
2. Quit Codync and remove the app the usual way for your system. With Homebrew: `brew uninstall --cask leepokai/codync/codync` for the app, or `brew uninstall leepokai/codync/codync-host` for the host. A host from the install script lives in `~/.local/bin`; delete `codync-host` there (on Linux also `codync-screen` and `cua-driver`).

`~/.codync` (on Windows, `.codync` in your user folder) holds your bots, conversations, routines, memory and the computer's identity. It stays after you uninstall. Delete it to remove all of it.

To erase everything from the desktop app in one step, choose **Settings → Reset all data…** in the menu bar or tray menu. It removes the computer from your account, revokes every paired device, signs you out, uninstalls the host, deletes its data and the app's settings, and restarts Codync at the welcome screen. With Homebrew, `brew uninstall --zap --cask leepokai/codync/codync` also deletes `~/.codync` and the app's settings.

### On the iPhone

In **Manage computers** (tap the connection status at the top of the Bots tab, such as **1 connected**), remove a computer. On the **Settings** tab, choose **Start over** to sign out and forget every computer. Deleting the app removes its cache. Your computers keep their bots and chats either way.