{"slug": "zuse-open-source-cloud-agents", "title": "Zuse: Open-Source Cloud Agents", "summary": "Zuse released an open-source, chat-first desktop app that wraps Claude Code, Codex, Grok, Gemini, Cursor, OpenCode, and Pi coding-agent CLIs in a persistent, project-aware interface with locally stored session history. The app ships x64 builds for macOS and Linux via a .deb installer and AppImage, requires at least one authenticated agent CLI, and adds per-chat git worktrees, a CodeMirror 6 editor, and hosted E2B cloud workspaces that continue running after the desktop app closes.", "body_md": "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.\n\nSupports macOS and x64 Linux. Requires at least one supported agent CLI installed.\n\nZuse currently ships x64 builds for Debian/Ubuntu and other Linux distributions that can run AppImages.\n\nInstall the latest `.deb` release directly from a terminal:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/swarajbachu/zuse/main/scripts/install-linux.sh | sh\n```\n\nThe installer downloads the `.deb` attached to the latest GitHub release,\nverifies its GitHub-published SHA-256 digest, and uses `apt`, which installs\nZuse's Secret Service and Avahi runtime dependencies. You may be prompted for\nyour `sudo` password.\n\nDownload the latest x64 `.AppImage` from\n[GitHub Releases](https://github.com/swarajbachu/zuse/releases/latest), then run:\n\n```\nchmod +x Zuse-*-linux-x86_64.AppImage\n./Zuse-*-linux-x86_64.AppImage\n```\n\nAppImage users must provide a Secret Service implementation, such as GNOME\nKeyring or KWallet. Install `avahi-publish-service` if you want nearby-device\ndiscovery.\n\nBefore starting an agent session, install and authenticate at least one of the\n[supported agent CLIs](#supported-agents). If a CLI installed through a version\nmanager is not detected, set its absolute binary path in Zuse's provider\nsettings.\n\n| Provider | CLI | \n|---|---|\n| Claude | `claude` | \n| Codex | `codex` | \n| Grok | `grok` | \n| Gemini | `gemini` | \n| Cursor | `cursor` | \n| OpenCode | `opencode` | \n| Pi | `pi` | \n\nPi: install with `npm install -g --ignore-scripts @earendil-works/pi-coding-agent`, then run `pi` and `/login`. See the [Pi provider guide](https://github.com/swarajbachu/zuse/blob/main/apps/docs/content/docs/providers/pi.mdx) for binary settings and native permissions.\n\n- Start and stop sessions for any supported provider, per project\n- Full streaming chat timeline — tool calls, thinking blocks, diffs, error bubbles\n- Turn summaries and loader states\n- Rate-limit error bubble with reset time\n- Answered `AskUserQuestion` cards rendered inline in the timeline\n\n- Slash commands: `/clear` ,`/new` ,`/model` ,`/mode` ,`/help`\n- `@` -mention file picker — fuzzy search any project file, inserts as an inline chip\n- Image and PDF attachments (drag-drop, paste, or button)\n- Plan mode with `AskUserQuestion` card and`Shift+Tab` flow\n- Mid-turn message queue\n\n- Smart permission policy with always-allow and per-session overrides\n- Redesigned permission prompt as a composer-slot card\n- Permission inspector\n\n- Cost-saving delegation — Opus 4.7 can spawn Haiku or Sonnet for sub-tasks\n- Collapsible wrapper rows in the chat timeline\n- Per-agent token accounting\n\n- Per-chat git worktrees — each session gets an isolated working tree\n- Per-repo settings\n- Scoped `@` -mentions within a worktree\n\n- Run invited coding-agent sessions in hosted E2B workspaces that continue when the desktop app closes\n- Send text messages while compute sleeps; Zuse accepts them into an encrypted durable mailbox, wakes the workspace, and shows delivery progress without duplicate provider sends\n- Open a workspace through its managed `ssh zuse-<workspace>` alias without exposing a public SSH listener\n- Keep a one-way, remote-authoritative Mac mirror under `~/.zuse/cloud/` that pauses on disconnect and resumes with fresh access\n- Open dev servers privately on Mac `localhost` ; public E2B preview URLs remain an explicit copy action\n\n- PR tab with markdown rendering\n- Changes tab with diff view\n- Commit composer\n- Checks tab with CI status glyphs\n\n- File tree with Material Icon Theme file-type icons\n- Click-to-open any file in the main pane\n- CodeMirror 6 editor — TS/TSX, JS, JSON, Markdown, HTML, CSS, Python, Rust, Go\n- Inline previews for PNG, JPEG, GIF, WebP, and AVIF images\n- `Cmd+S` to save, mtime-based optimistic concurrency\n\n- Three-pane layout: sidebar / chat / files+terminal\n- `Cmd+K` opens a compact, scrollable palette with five recent chats, quick actions, settings destinations, and workspace/navigation commands; search together, or type`>` for commands only\n- `Cmd+P` searches files in the current project or worktree, also available from quick actions and the file-tree header\n- Resizable panes\n- Top bar with active session info\n- PTY terminal (Ghostty VT + node-pty)\n- macOS Keep Mac awake modes: Auto while an agent or authenticated remote client is active, Always, or Off, with live status in General settings\n\n- SQLite stores projects, sessions, messages, tool calls across restarts\n- Keychain-backed API keys (no plaintext storage)\n- Signed + notarized macOS universal `.dmg` (Apple Silicon + Intel)\n- Linux x64 `.AppImage` and Debian/Ubuntu`.deb`\n- In-app auto-update via GitHub Releases\n\n| Shell | Electron 42 | \n| Renderer | React 19 + TypeScript + Vite | \n| Styling | Tailwind CSS v4 + shadcn/ui (zinc dark) | \n| State | Zustand (ephemeral) + SQLite (persistent) | \n| IPC | @effect/rpc with Electron IPC transport | \n| Runtime | Effect.ts (Layer, Stream, Schema) | \n| Terminal | Ghostty VT (WebAssembly/native) + node-pty | \n| Editor | CodeMirror 6 | \n| Monorepo | Bun workspaces + Turbo | \n\n```\napps/\n  desktop/     Electron shell\n  renderer/    React UI (Vite)\n  server/      All backend logic — Effect Layers\n  web/         Next.js marketing site\npackages/\n  contracts/   @zuse/contracts — typed RPC contracts + branded IDs\n  ui/          Shared React components\nspecs/\n  0.01-MVP/    Foundation\n  0.02-MVP/    File viewer & editor\n  0.03-MVP/    Composer 2.0\n  0.04-MVP/    Code index (spec complete, not yet built)\n  sub-agents/  Sub-agent delegation\n```\n\n- [Public documentation](https://github.com/swarajbachu/zuse/blob/main/apps/docs/content/docs) : published customer-facing content\n- [Repository cloud guides](https://github.com/swarajbachu/zuse/blob/main/internal-docs/cloud/README.md) : workspace usage, public API,\nSlack automations, and operations\n\n- [Internal documentation map](https://github.com/swarajbachu/zuse/blob/main/internal-docs/README.md) — engineering and operator references\n- [Desktop design system](https://github.com/swarajbachu/zuse/blob/main/DESIGN.md) — visual foundations, component patterns,\naccessibility, and responsive behavior\n- [Realtime runtime](https://github.com/swarajbachu/zuse/blob/main/internal-docs/architecture/realtime-runtime.md) — the durable\nsession and ClientBus path shared by local, SSH, and cloud environments\n- [Unified computers](https://github.com/swarajbachu/zuse/blob/main/internal-docs/specs/unified-computers.md) — environment and sandbox\ndomain model\n- [Context map](https://github.com/swarajbachu/zuse/blob/main/CONTEXT-MAP.md) — domain contexts and their ownership relationships\n\n```\n# Install\nbun install\n\n# Dev (renderer + Electron)\nbun dev\n\n# Build\nturbo build\n\n# Package macOS DMG (signed)\nbun run dist:mac\n\n# Package macOS DMG (unsigned, local testing)\nbun run dist:mac:unsigned\n\n# Package Linux AppImage and deb\nbun run dist:linux\n\n# Package Linux without publishing\nbun run dist:linux:unsigned\n```\n\nRequires: Bun 1.3.10+, Node.js ≥ 22.13, and macOS or x64 Linux.\n\nChanges to the macOS awake controller require the\n[physical MacBook release check](https://github.com/swarajbachu/zuse/blob/main/internal-docs/testing/mac-computer-awake.md), including\nassertion and best-effort closed-lid verification.\n\nThe 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.\n\nLicensed developers can opt into the paid icon styles by exporting\n`HUGEICONS_TOKEN` before `bun install`. The install hook downloads the licensed\npackages into an isolated local directory; they are never added to the public\nworkspace dependency graph. If lifecycle scripts were disabled, run\n`bun run icons:install-paid`, then confirm the active set with\n`bun run icons:status --expect=paid`.\n\nThe packaging commands build x64 artifacts into `dist/`. End-user installation\ninstructions are in [Install on Linux](#install-on-linux).\n\nExcept where third-party terms apply, Zuse's source code is licensed under the\n[GNU Affero General Public License v3.0 only](https://github.com/swarajbachu/zuse/blob/main/LICENSE) (`AGPL-3.0-only`).\nSmall areas with close correspondence to MIT-licensed upstream software retain\nthe applicable copyright and permission notice. Reference-driven pull requests,\nlibrary foundations, and the code-level inventory are documented in\n[Attribution and provenance](https://github.com/swarajbachu/zuse/blob/main/THIRD_PARTY_NOTICES.md).\n\nZuse also builds on ideas and foundations from the wider open-source community. We are grateful to the contributors whose work made this project possible.", "url": "https://wpnews.pro/news/zuse-open-source-cloud-agents", "canonical_source": "https://github.com/swarajbachu/zuse", "published_at": "2026-09-24 23:01:38+00:00", "updated_at": "2026-09-24 23:31:13.868293+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "developer-tools", "ai-products"], "entities": ["Zuse", "Claude Code", "Codex", "Grok", "Gemini", "Cursor", "OpenCode", "E2B"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/zuse-open-source-cloud-agents", "markdown": "https://wpnews.pro/news/zuse-open-source-cloud-agents.md", "text": "https://wpnews.pro/news/zuse-open-source-cloud-agents.txt", "jsonld": "https://wpnews.pro/news/zuse-open-source-cloud-agents.jsonld"}}