selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codync logo

Self-host Codync

v2.31.0

AI coding agents as persistent bots on your phone

ReleaseOpen SourceApache-2.0
Updated8 hours ago
LanguageRust
Setup difficultyModerate
MobileNative app
Stars
969
CPU
x86_64 or arm64
Port
19222 (codync-host HTTP/SSE API for local clients)
Requires
Ca-certificates
Install with Linux
Chat view showing a bot's reply with code changesGroup chat with multiple bots collaboratingiOS Home Screen widget showing bot status and usageLive Activity on Lock Screen with bot status and thinking orbDynamic Island showing bot avatar and thinking orbDesktop app on macOS with four bots in sidebar and welcome screenLaunch film thumbnail showing Codync in action

What is Codync?

Codync is a self-hosted application that runs on your computer (macOS, Windows, or Linux) and turns locally installed AI coding agents — including Claude Code, Codex, Cursor, Gemini CLI, Copilot, and about 40 more via the Agent Client Protocol — into persistent named bots. You interact with these bots from a native iPhone app (SwiftUI), a cross-platform desktop app (Electron), or a terminal UI over SSH. Each bot has its own agent, project folder, approval policy, and persistent chat with reply threading. Multiple bots can collaborate in group chats, ask each other for help via a built-in MCP server, and fall back to alternate agents when one hits usage limits. The host (codync-host) is a single Rust binary that manages agent sessions via ACP, stores transcripts in SQLite, and serves clients over an end-to-end encrypted channel (direct on local network/Tailscale, or via a free Cloudflare relay). Features include approval cards, per-bot memory, routines, remote screen control via WebRTC, voice calls, push notifications with encrypted content, Home Screen widgets, Live Activities, and Dynamic Island integration on iOS. No account is required; pairing uses a QR code. The project is Apache 2.0 licensed with no paid tier.

Should you self-host Codync?

Codync scores 59/100 on selfhost.directory (how scoring works) and ranks #21 of 120 in AI Assistant. It has 969 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v2.31.0, came out on 27 October 2026.

Setup is moderate: expect some configuration beyond a single command. It is Apache-2.0-licensed and written mostly in Rust.

Its closest alternative on selfhost.directory is OpenMausBot (74/100, 5 829 stars). It scores higher overall, so compare the two before you pick. See Codync vs OpenMausBot side by side.

Features

  • Agent-agnostic via ACP
  • Agent fallbacks
  • Approval cards
  • Bot collaboration
  • End-to-end encrypted remote access
  • Group chats
  • iOS widgets and Live Activities
  • Multi-computer management
  • Per-bot memory
  • Persistent named bots
  • Push notifications with encrypted content
  • Remote screen controlNot available on Windows yet
  • Routines
  • Terminal UI (TUI)
  • Voice calls

Codync README

How to install Codync

Install Codync with Linux

Linux with Homebrew
Environment variables
CODYNC_VERSION, CODYNC_BIN_DIR

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

For headless/servers: curl -fsSL ... | sh -s -- --host-only

Also available as .deb and .tar.gz; desktop app installs automatically via install.sh when display present

How to configure Codync

  • CODYNC_BIN_DIR~/.local/bin (or /usr/local/bin as root)Directory where binaries are installed

    Directory where binaries are installed

    values: any valid path

  • CODYNC_VERSIONlatestRelease tag to install (default: latest)

    Release tag to install (default: latest)

    values: e.g. v2.2.1

Codync releases & version history

FAQ

Is it safe to let bots work on my computer?

Bots act with your permissions. When an agent asks to edit files or run a command, the request comes to your phone to allow once, always allow, or deny. Give bots work you trust, and keep backups.

What happens when my agent runs out of usage?

Give the bot fallbacks and the next agent in its list carries on with the same turn, chat, memory, and folder. The bot goes back to its own agent once that one resets. Without fallbacks, the chat offers to add one.

Which computers can run it?

A Mac, a Windows PC, or a Linux desktop or headless server. The iPhone app and terminal UI over SSH talk to the same host.

Where does my data go?

Bots, chats, and memory stay on your computer. Your phone reaches it directly on the same network or through an end-to-end encrypted relay that can't read your messages.

How is it different from Grok Bot, Muse or Dots?

Same bot-based way of working (named bots, group chats, replies, approvals, memory) but open source, free, running on your own computer, and with any coding agent.

Which agents can it run?

Claude Code, Codex, Cursor, Gemini, Copilot, OpenCode, and about 40 more through the Agent Client Protocol registry. Each bot picks its own agent.

Can I use my Claude or ChatGPT plan?

Yes. Codync runs the agents already signed in on your computer: Claude Code with your Claude plan, Codex with your ChatGPT plan, etc. It never calls a provider's API with your login.

Is Codync free?

Yes, Codync costs $0 with every feature included and is Apache 2.0 licensed. You only pay your agent's provider through the plan or key you already have.

More in Remote Access

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…