Zerus

Your agents. Your machines. One workspace.
One interface for native agent harnesses, with their tools, hooks and workflows.
Projects, session assignments and shared settings sync directly between peers.

Install   |   Features   |   Android and iOS   |   Reference
Linux and macOS   |   Android and iOS   |   Windows   |   P2P   |   MIT

Claude Code   Codex   Kimi Code   DeepSeek Harness   OpenCode

Zerus is an **Agent Development Environment (ADE)** where your machines are peers in one shared workspace. A project can include folders and agent sessions on several hosts. The project catalog, session assignments and shared recovery settings sync directly between machines, with no permanent main machine. Work from your laptop or workstation using the SSH access configured there. Bring your own agents and subscriptions. **Claude Code, Codex, Kimi Code, DeepSeek Harness and OpenCode** run in their own native runtimes. Zerus brings their Activity, messages, questions, approvals and session controls together, while their original tools, hooks, permissions and history remain with the native harness. Agents from different providers can discover sessions, read progress and exchange messages through the built-in `hgs` CLI, locally or over SSH. Available controls depend on the agent and its version. You can run **any terminal command** through `hgs`; full ADE features need an adapter. Missing your agent or a feature? [Send a PR](https://github.com/ufna/zerus/pulls) or [let us know](https://github.com/ufna/zerus/issues).

Zerus workspace with multiple agents, Activity, subagents and tasks in one window

## Features

Your whole fleet at a glance

See machines, running sessions and requests for attention in one overview. Search, filters and project groups help you work with dozens or hundreds of agents. Machine load and account limits are right alongside them.

Overview of 112 synthetic sessions on four machines, with activity and resource use

One shared workspace across your machines

A project brings together folders and agents on your laptop, workstation and servers. The project catalog, session assignments and shared recovery settings sync peer to peer over SSH. Each machine keeps a copy, with no permanent main machine. Switch to another connected computer and keep the same project organization. Offline peers catch up when they reconnect; SSH access, credentials and appearance stay local.

The Orbit project connects folders on a workstation, a MacBook and two servers

Notifications that lead to the right session

Know when an agent finishes, asks a question, requests approval or hits an error. A click takes you to that session's Activity, including remote sessions. Read replies, send messages and images, and follow subagents and tasks alongside the conversation.

A remote DeepSeek Harness session waiting for a review-scope choice in Activity
### Native harnesses, working together Use each provider's agent in its own environment, with its native tools and workflows. Zerus preserves existing hooks while adding session tracking and connects native events to the shared workspace. Supported integrations also expose their original Terminal or Native UI for provider-specific features. **Agent-to-agent communication is built in.** For example, let Codex implement a change and Claude review it. Agents with shell access can use `hgs ls` to find sessions, `hgs inspect` to read their progress and `hgs send` to exchange tasks and results, including on another machine through `hgs @host`. Each recipient continues in its own native conversation. The same inspection and message interfaces serve the desktop and other clients. [CLI protocol and delivery guarantees](docs/reference.md#json-and-external-clients). **Local coding models** can run on your own computer through Ollama. Keep the agent harness and inference provider separate: use the existing Codex adapter with a local model, or the [OpenCode native adapter](docs/opencode.md). [Setup and qualified local example](docs/local-models.md). ### Voice control across agents and devices Speak a task to **Claude Code, Codex, Kimi Code, DeepSeek Harness or OpenCode** from the desktop or Android app. Record, review and send: Zerus transcribes the recording and delivers the text to the selected agent's native conversation, including on another connected computer. Your message stays in Activity as a **playable voice message with a waveform and expandable transcript**, so you can compare what you said with what the agent received. Camera mode records video circles with the same hold, cancel and lock controls on desktop and Android; the video stays in history and its recognized speech goes to the agent. Choose the processing computer and manage its recognition profiles in **Settings → Voice input**. Use **local GigaAM v3 for Russian**, including GPU inference, or an **OpenAI-compatible transcription server** at your own URL. Your phone reaches the processing computer through the relay; it does not need to run the model. Agent choice and speech provider choice are independent. [Set up a speech provider](docs/speech-setup.md) | [Voice messages and delivery](docs/voice-messages.md) ### Your fleet from your phone The **Android and iOS apps** bring your projects and agents to your phone: - **Conversations and tasks.** Read replies, follow goals, task lists and subagents, answer questions and approvals, and send messages with files and images. - **Voice control.** Send recorded tasks to any supported agent, play your voice messages back and view their transcripts. Choose recognition profiles on a connected computer, including local models and remote transcription servers. - **Remote controls.** Create sessions with the computer's native agent and account; change models, clear or compact context, inspect processes and open the native terminal where supported. - **Your workspace.** Filter sessions across machines, browse project folders and check account limits. Private drafts and cached conversations stay available offline. Pair your phone with a computer to reach it and its directly connected Zerus peers through a **self-hostable HTTPS relay**. Notifications use Firebase Cloud Messaging on Android, with a foreground live connection for phones without it, and Apple Push Notifications on iPhone. The native **iOS app** (SwiftUI, iOS 18 or later) has the same features as Android and is open to everyone through the TestFlight public beta until its App Store release. [Download the Android APK](https://zerus.dev/#download) | [Join the iOS beta on TestFlight](https://testflight.apple.com/join/fywRuW6y) | [Connect your phone](docs/mobile-deployment.md#pair-the-phone) | [Architecture and trust model](docs/mobile-architecture.md)
Your sessions Talk to your agents Accounts and limits
Android session overview with agents on a workstation, MacBook and build server A conversation with Codex in the Android client Shared Codex, Claude and Kimi accounts with usage limits across machines
Sessions on iPhone Conversations on iPhone Projects on iPhone
iPhone session overview with Codex, Claude and Kimi sessions on a design workstation A Codex conversation with a table, code and a task list in the iOS client A project with folders on two machines in the iOS client
### Persistent sessions, your choice of client Terminal agents run in **tmux**. Closing Zerus, losing SSH or putting your laptop to sleep leaves sessions on a running host intact. Attach from the built-in Terminal, a regular terminal over SSH or another client, even one without Zerus. Supported agents also have pause/resume with an exact conversation binding. **DeepSeek Harness** uses the official native engine and an embedded **Native UI** alongside Activity. Its host also keeps working after you close the window. [Integration details](docs/reference.md#deepseek). ## Yet another ADE > One project, agents on several machines. I wanted to work from the laptop or > workstation with the same projects and session assignments available on both. > > That is the reason for the P2P workspace. Each machine keeps the shared catalog > and exchanges changes directly with its peers, with no permanent main machine. > The folders and agents stay on their hosts; the project organization and shared > settings follow you between connected computers. > > Terminal agents run in ordinary tmux sessions. Work through Zerus or connect to > the same session from any SSH client, using the SSH access configured on that > computer. > > — [Vladimir / @ufna](https://github.com/ufna) ## Quick start ### macOS — Homebrew or DMG For Apple Silicon Macs running macOS 14 or later: ```sh brew install --cask ufna/zerus/zerus zerus-setup ``` Run `zerus-setup` once as your normal user, without `sudo`. Prefer a download? [Get the signed, notarized DMG](https://zerus.dev/#download-macos), then follow the [DMG installation steps](docs/installation.md#macos-dmg). ### Windows — portable ZIP [Download Zerus for Windows](https://zerus.dev/#download-windows). Extract the whole `zerus--windows-x86_64.zip` archive and launch **`hgs-tray.exe`** from the extracted folder. The CLI, **`hgs.exe`**, is included; keep the bundled files together. No installer or WSL is required. Requires Windows 10 version 1903 or later, or Windows 11, on x86_64. Connect to Linux/macOS agents over SSH, or enable **local sessions** in Machines to run agents on Windows itself. See the [Windows guide](docs/installation.md#windows) for setup and supported features. The ZIP is also on the [latest stable release page](https://github.com/ufna/zerus/releases/latest). ### Linux — Arch package or source On Arch Linux x86_64: ```sh yay -S zerus-ade-bin zerus-setup ``` Run setup as your normal user. [Source and development packages](docs/installation.md#arch-linux) are also available. Other Linux distributions [build from source](docs/installation.md#local-installation). ### Start a session [Install Zerus and the CLI](docs/installation.md), then use **New session** to choose an agent, machine, project and folder. Ordinary folders without Git work too. Add other machines through SSH in **Machines**. The same sessions are available from your terminal: ```sh hgs codex /workspace/orbit -n api # local agent in tmux hgs @build-01 claude /workspace/orbit # agent on another machine hgs ls # sessions here and on connected machines hgs status # versions and running services here and there hgs a codex/orbit/api # attach from any terminal ``` **On Android:** [download the APK](https://zerus.dev/#download), then [pair your phone](docs/mobile-deployment.md#pair-the-phone). **On iPhone:** [join the TestFlight beta](https://testflight.apple.com/join/fywRuW6y), then pair it the same way, from **Pair a phone…** in Machines on a computer. **Try demo** lets you explore the interface before connecting a computer. ## Other platforms Prebuilt Linux packages currently exist only for Arch Linux x86_64. Other Linux distributions [build from source](docs/installation.md#local-installation) with the same installer. Zerus is open source: apt, dnf and other packages are welcome as pull requests. **macOS**: Apple Silicon Macs running macOS 14 or later can install a signed and notarized stable release from the [DMG](docs/installation.md#macos-dmg) or [Homebrew tap](docs/installation.md#macos-homebrew): `brew install --cask ufna/zerus/zerus`, then `zerus-setup`. Daily Nightly and successful main CI Dev builds use `ufna/zerus/zerus@nightly` and `ufna/zerus/zerus@dev`, respectively. **Settings > Updates** checks versions and provides the update command or DMG. Source builds remain available through the same installer. **Windows**: stable and nightly releases include the portable x86_64 ZIP described [above](#windows--portable-zip). Dev builds have no Windows asset. Local sessions use a native ConPTY session host; remote sessions use SSH. [Windows support plan](docs/superpowers/specs/2026-10-10-windows-support-design.md) [Command and settings reference](docs/reference.md) | [CI and Arch packages](docs/ci-and-aur.md) | [MIT](LICENSE)