zuse README

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

Zuse Alpha

A chat-first desktop app for developers who work with AI coding agents. Wraps Claude Code, Codex, Grok, Gemini, Cursor, and OpenCode in a persistent, project-aware interface — structured chat history, rich composer, file viewer, integrated terminal, git worktrees, and session management, all stored locally.

Supports macOS and x64 Linux. Requires at least one supported agent CLI installed.

Install on Linux

Zuse currently ships x64 builds for Debian/Ubuntu and other Linux distributions that can run AppImages.

Debian and Ubuntu

Install the latest .deb release directly from a terminal:

curl -fsSL https://raw.githubusercontent.com/swarajbachu/zuse/main/scripts/install-linux.sh | sh

The installer downloads the .deb attached to the latest GitHub release, verifies its GitHub-published SHA-256 digest, and uses apt, which installs Zuse's Secret Service and Avahi runtime dependencies. You may be prompted for your sudo password.

Other distributions

Download the latest x64 .AppImage from GitHub Releases, then run:

chmod +x Zuse-*-linux-x86_64.AppImage
./Zuse-*-linux-x86_64.AppImage

AppImage users must provide a Secret Service implementation, such as GNOME Keyring or KWallet. Install avahi-publish-service if you want nearby-device discovery.

Before starting an agent session, install and authenticate at least one of the supported agent CLIs. If a CLI installed through a version manager is not detected, set its absolute binary path in Zuse's provider settings.

Supported agents

Provider CLI
Claude claude
Codex codex
Grok grok
Gemini gemini
Cursor cursor
OpenCode opencode
Pi pi

Pi: install with npm install -g --ignore-scripts @earendil-works/pi-coding-agent, then run pi and /login. See the Pi provider guide for binary settings and native permissions.

What's shipped

Agent sessions

Composer

Permission system

Sub-agents

Git worktrees

Cloud workspaces

PR & Changes pane

File viewer & editor

Layout & UI

Persistence & distribution

Tech stack
Shell Electron 42
Renderer React 19 + TypeScript + Vite
Styling Tailwind CSS v4 + shadcn/ui (zinc dark)
State Zustand (ephemeral) + SQLite (persistent)
IPC @effect/rpc with Electron IPC transport
Runtime Effect.ts (Layer, Stream, Schema)
Terminal Ghostty VT (WebAssembly/native) + node-pty
Editor CodeMirror 6
Monorepo Bun workspaces + Turbo

Monorepo layout

apps/
  desktop/     Electron shell
  renderer/    React UI (Vite)
  server/      All backend logic — Effect Layers
  web/         Next.js marketing site
packages/
  contracts/   @zuse/contracts — typed RPC contracts + branded IDs
  ui/          Shared React components
specs/
  0.01-MVP/    Foundation
  0.02-MVP/    File viewer & editor
  0.03-MVP/    Composer 2.0
  0.04-MVP/    Code index (spec complete, not yet built)
  sub-agents/  Sub-agent delegation

Documentation

Internal and contributor references

Dev setup

# Install
bun install

# Dev (renderer + Electron)
bun dev

# Build
turbo build

# Package macOS DMG (signed)
bun run dist:mac

# Package macOS DMG (unsigned, local testing)
bun run dist:mac:unsigned

# Package Linux AppImage and deb
bun run dist:linux

# Package Linux without publishing
bun run dist:linux:unsigned

Requires: Bun 1.3.10+, Node.js ≥ 22.13, and macOS or x64 Linux.

Changes to the macOS awake controller require the physical MacBook release check, including assertion and best-effort closed-lid verification.

The default install uses the public icon set and does not require registry credentials. Contributors can clone the repository and run the commands above without any additional setup.

Licensed developers can opt into the paid icon styles by exporting HUGEICONS_TOKEN before bun install. The install hook downloads the licensed packages into an isolated local directory; they are never added to the public workspace dependency graph. If lifecycle scripts were disabled, run bun run icons:install-paid, then confirm the active set with bun run icons:status --expect=paid.

The packaging commands build x64 artifacts into dist/. End-user installation instructions are in Install on Linux.

License and acknowledgements

Except where third-party terms apply, Zuse's source code is licensed under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). Small areas with close correspondence to MIT-licensed upstream software retain the applicable copyright and permission notice. Reference-driven pull requests, library foundations, and the code-level inventory are documented in Attribution and provenance.

Zuse also builds on ideas and foundations from the wider open-source community. We are grateful to the contributors whose work made this project possible.

zuse (swarajbachu/zuse)

Searching Database…

232 ·GitHub
Zuse
Что это?Zuse — это настольное приложение с чат-ориентированным интерфейсом, которое оборачивает несколько CLI AI-агентов для кодинга (Claude Code, Codex, Grok, Gemini, Cursor, OpenCode, Pi) в один постоянный интерфейс с учётом проекта, с историей чатов, просмотрщиком файлов, встроенным терминалом и git worktree — всё хранится локально.
Как установить Zuse на Linux или macOS?На Debian/Ubuntu запустите установочный скрипт в терминале: он скачает последний .deb-релиз, проверит его SHA-256 и установит через apt. Пользователи других Linux-дистрибутивов могут скачать x64 .AppImage с GitHub Releases, а пользователям macOS предлагается подписанный и нотаризованный universal .dmg.
Нужно ли отдельно устанавливать Claude Code, Codex или другой агентский CLI?Да — Zuse это лишь интерфейс-обёртка. Вы должны сами установить и авторизовать хотя бы один поддерживаемый агентский CLI (Claude, Codex, Grok, Gemini, Cursor, OpenCode или Pi) перед началом сессии.
Это альфа-версия, и есть ли подводные камни при установке на Linux?Проект явно помечен как 'Zuse Alpha'. На Linux пользователям AppImage нужно самостоятельно предоставить реализацию Secret Service (например, GNOME Keyring или KWallet) для хранения учётных данных, так как в комплект она не входит.
Работает ли Zuse и на Windows?Нет — сейчас Zuse выпускается только для macOS (Apple Silicon и Intel) и x64 Linux (deb/AppImage); нативной сборки для Windows нет.
Как хранятся мои API-ключи?API-ключи хранятся в связке ключей ОС, а не записываются на диск в открытом виде.
Для чего нужна функция облачных рабочих пространств?Zuse может запускать приглашённые сессии кодинг-агентов в хостинговых рабочих пространствах E2B, которые продолжают работать после закрытия настольного приложения: сообщения складываются в зашифрованный почтовый ящик, рабочее пространство пробуждается для их доставки, а на Mac ведётся одностороннее зеркало в ~/.zuse/cloud/.
Что мне дают git worktree здесь?Каждая чат-сессия получает собственное изолированное git worktree с настройками по репозиторию и ограниченными упоминаниями файлов, так что можно параллельно запускать несколько сессий агентов на одном репозитории, не мешая изменениям друг друга.
Что встроено в панели файлов и терминала?Редактор CodeMirror 6 с поддержкой синтаксиса TS/JS, Python, Rust, Go и других языков, встроенные предпросмотры PNG/JPEG/GIF/WebP/AVIF и PTY-терминал на базе Ghostty VT и node-pty — всё это в масштабируемом трёхпанельном интерфейсе.
Как Zuse работает с суб-агентами и расходами?Крупная модель вроде Opus 4.7 может порождать более дешёвые Haiku или Sonnet для подзадач; они показаны как сворачиваемые вложенные строки в таймлайне чата с учётом токенов по каждому агенту, чтобы помогать контролировать расходы.
What are similar projects?casbin-gateway, vicoa, Codync, superpowers-zh, ordewell, emdash, adhdev, claurst
Which topics is it in?worktrees, pty, turborepo, agentic-coding, shadcn-ui, electron-app, bun, ai-coding, agplv3, ssh, opencode, coding-agents
Creator
swarajbachu
Size
70.8 MB
Stars
232
Updated
CommitOct 18Releasev0.24.0Oct 17
Age
5mo
Commits · 90 Days