zeron README

The project's README from github.com/zeronsh/zeron. As one markdown file: README.md.

Zeron

Control your coding agents (Claude Code, Codex, Cursor, Devin, Grok, Hermes, Pi, Antigravity) locally by default, with optional multi-device sync.

English | 简体中文

Zeron driving a Claude Code session with a live branch diff sidebar

Every device runs a small engine that stores sessions on that device. A new installation starts in local-only mode without an account or a network connection.

Install and run locally (Linux)

curl -fsSL https://zeron.sh/install.sh | sh
zeron status

The installer starts the daemon immediately and keeps it running across reboots. No sign-in or sync configuration is required.

The desktop sidebar browser also needs the Linux browser runtime.

Day-to-day:

zeron status      # local/synced mode and engine status
zeron update      # update to the latest release
zeron daemon start|stop|restart|status

Optional multi-device sync

Sign in only when you want to open your account's synced workspace. Authentication changes the profile selected by the next engine start, so stop the daemon before changing it:

zeron daemon stop
zeron login
zeron daemon start

You can then start an agent on one synced device and follow or drive it from another. An always-on machine such as a VPS can keep those agents working after you close your laptop.

Devices signed in to the same synced account are trusted with remote workspace access. A device controlling a workspace on another device can list, read, and write its files; enabling Show ignored files also makes gitignored files such as .env available remotely. .git is always excluded. Only sign in devices you trust with the full contents of your workspaces.

Signing in does not upload, move, or import existing local sessions. Local sessions and their attachments remain under the local profile and reappear when you return to local-only mode:

zeron daemon stop
zeron logout
zeron daemon start

zeron login and zeron logout refuse to modify credentials while an engine owns the data directory. The desktop app follows the same next-restart profile boundary.

On macOS: use the desktop release, or build zeron from source and run zeron daemon install to install the launchd service.

On Windows: extract the portable release ZIP and run zeron.exe. Keep zeron-update.json beside it for in-app updates. See the development notes for source builds.

Sponsors

Thank you to The Context Company for sponsoring Zeron.

You can help fund Zeron's development too. Individuals and companies are welcome to become a sponsor on GitHub.


Developing or curious how it works? Ask DeepWiki or check out ARCHITECTURE.md.

Licensed under the MIT License.

zeron (zeronsh/zeron)

Searching Database…

3.3K ·GitHub
Что это?Zeron — нативная десктопная управляющая плоскость, позволяющая запускать, отслеживать и переключаться между несколькими агентами для кодинга (Claude Code, Codex, Cursor, Devin, Grok, Hermes, Pi, Antigravity) из одного приложения, причём каждое устройство по умолчанию хранит свои сессии локально.
Это десктопное приложение или скорее фоновый сервис?И то и другое: на каждом устройстве работает небольшой фоновый движок (демон), хранящий сессии агентов локально, в паре с десктопным интерфейсом, а установщик оставляет этот демон работать после перезагрузок.
Как установить и запустить Zeron?На Linux установщик сразу запускает демон без какой-либо настройки. На macOS используйте десктопный релиз или соберите из исходников и выполните «zeron daemon install» для службы launchd. На Windows распакуйте переносимый ZIP-релиз и запустите zeron.exe.
Нужен ли аккаунт или интернет для использования?Нет — свежая установка стартует в режиме «только локально», без аккаунта и сетевого подключения. А вот боковому браузеру в Linux-десктопе нужен установленный браузерный рантайм.
Есть ли подводные камни при переключении между локальным и синхронизированным режимами?Да — вход в аккаунт меняет, какой профиль загрузится при следующем старте движка, поэтому перед переключением нужно остановить демон, а «zeron login»/«zeron logout» отказываются выполняться, пока движок владеет каталогом данных.
Можно ли оставить агентов работать на сервере после закрытия ноутбука?Да — при включённой синхронизации постоянно включённая машина вроде VPS может продолжать держать агентов работающими после закрытия ноутбука, а управлять ими можно с другого синхронизированного устройства.
Что видят другие устройства, когда я включаю синхронизацию?Устройства, вошедшие в тот же синхронизированный аккаунт, получают полное доверие и удалённый доступ к рабочему пространству: они могут перечислять, читать и писать его файлы, а включение «Показывать игнорируемые файлы» открывает даже файлы из .gitignore вроде .env (хотя .git всегда исключён). Вход в аккаунт никогда не выгружает ваши существующие локальные сессии.
Какими агентами для кодинга может управлять Zeron?Claude Code, Codex, Cursor, Devin, Grok, Hermes, Pi и Antigravity.
Можно ли управлять сессией агента с другого устройства?Да — когда два устройства вошли в один синхронизированный аккаунт, можно запустить агента на одном и следить за ним или управлять им с другого.
Если я вхожу для синхронизации, мои существующие локальные сессии выгружаются?Нет, вход в аккаунт не выгружает, не перемещает и не импортирует существующие локальные сессии; они остаются в локальном профиле и появляются снова, если переключитесь обратно в режим «только локально».
Creator
zeronsh
Size
130.5 MB
Stars
3.3K
Age
2mo
Commits · 90 Days