Skip to content

Reading the repo

Opening the box…

How to install Codync on Linux (leepokai/Codync) · gitmanual

How to install on Linux

leepokai/Codync

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.

Shell scripts#acp#agent-client-protocol#ai-agents#ai-assistant

Before you start

Is it free?: YesOpen source (Apache-2.0).
Still maintained?: Yes, activeLast change today. Latest release v2.47.0, yesterday.
How widely used?: Some track record2.1k stars, 8 months old. Get it from the official repo and read what it installs.

Difficulty: Easy
Time: about 5 min
Stars: ★ 2,104
Activity: Updated this month

Saved setup from 10 h ago

Will it work on Linux?

Yes, it installs on your Linux

A ready-made Linux download is in the latest release.

Supported devices from the README: Platforms

| | Platform | App | Highlights | |---|---|---|---| | 📱 | iPhone | Native SwiftUI | Chat with bots, approvals, push notifications, Live Activity, widgets, remote screen, voice calls | | 💻 | macOS | Desktop app (Electron), menu bar + window | Runs the host, chat window, usage in the menu bar, iPhone pairing | | 🪟 | Windows | Desktop app (Electron), tray + window | Runs the host, chat window, iPhone pairing (no remote screen yet) | | 🐧 | Linux | Desktop app (Electron), tray + window | Chat window, iPhone pairing; the host runs on desktops and headless servers | | ⌨️ | Terminal | codync-host tui | Message your bots from any terminal, over SSH too |

The host (codync-host, Rust) runs on macOS, Windows and Linux; every client talks to it, so all your bots and chats are the same everywhere.

Looking for the former native Mac app (SwiftUI + AppKit)? Version 2.7.0 moved Mac and Linux to one Electron desktop app. The native implementation is preserved in Git history at 1055636; see the archived AppKit chat implementation notes.

Your system

macOS Windows Linux

Start here

Website ↗codync.devThe project's own site.

Heads-upBuilding it yourself? It also needs 1 setting in .env (1 secret).

Download for Linux

v2.47.0 · 11/14/2026 ↗

codync-linux-x86_64.AppImage

AppImage · x64 · 127.2 MB · 23 downloads · best match

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-x86_64.AppImage"
chmod +x "codync-linux-x86_64.AppImage"
./"codync-linux-x86_64.AppImage"

Other Linux downloads (7)

codync-linux-x86_64.deb

deb · x64 · 100.4 MB · 2 downloads

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-x86_64.deb"
sudo apt install ./"codync-linux-x86_64.deb"

codync-host-linux-x86_64.tar.gz

tar.gz · x64 · 39.4 MB · 255 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-host-linux-x86_64.tar.gz"
tar -xzf "codync-host-linux-x86_64.tar.gz"

codync-linux-arm64.AppImage

AppImage · ARM64 · 128.5 MB · 4 downloads

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-arm64.AppImage"
chmod +x "codync-linux-arm64.AppImage"
./"codync-linux-arm64.AppImage"

codync-linux-x86_64.tar.gz

tar.gz · x64 · 121.1 MB · 1 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-x86_64.tar.gz"
tar -xzf "codync-linux-x86_64.tar.gz"

codync-linux-arm64.deb

deb · ARM64 · 95.5 MB · 1 downloads

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-arm64.deb"
sudo apt install ./"codync-linux-arm64.deb"

codync-host-linux-arm64.tar.gz

tar.gz · ARM64 · 37.9 MB · 25 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-host-linux-arm64.tar.gz"
tar -xzf "codync-host-linux-arm64.tar.gz"

codync-linux-arm64.tar.gz

tar.gz · ARM64 · 122.0 MB · 1 downloads

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/leepokai/Codync/releases/download/v2.47.0/codync-linux-arm64.tar.gz"
tar -xzf "codync-linux-arm64.tar.gz"

Install with a package manager

Alternative: install script

curl -fsSL https://raw.githubusercontent.com/leepokai/Codync/main/packaging/install.sh | sh

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for Linux yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 9 key files and writes a step-by-step guide for Linux. Once written, it's saved for everyone.

Pro Deep Inspection

What the README leaves outCheck for missing setup steps, undocumented settings, license concerns, exposed secrets, and known dependency vulnerabilities.See what needs attention before you invest time in this repo.Unlock Deep Inspection →

Parts list

1× settings in .env

CODYNC_CLERK_SECRET_KEYsecret

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/leepokai/Codync/badge.svg)](https://gitmanual.com/leepokai/Codync)

Good to know

Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: apps/desktop/package.json, apps/screen-linux/Cargo.toml, cloud/machines/package.json, cloud/package.json and 10 more

Details

License: Apache-2.0
Open issues: 132
Branch: main

Files we read (9)

.env.development.example

.env.production.example

.github/workflows/accounts-crate.yml

.github/workflows/android-submit.yml

.github/workflows/android.yml

.github/workflows/auto-tag.yml

.github/workflows/cloud.yml

.github/workflows/contributor.yml

README.md

4,220 files in the repo