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).
## 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.
|
|
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.
|
|
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.
|
|
### 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 |
 |
 |
 |
| Sessions on iPhone |
Conversations on iPhone |
Projects on iPhone |
 |
 |
 |
### 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)