Run AI coding agents on your own machine — Mac or server.
Connect from desktop, phone, browser, or Slack. Agents keep working when you walk away.
Website · Discord · Releases · Contributing
Deus turns any machine into an always-on AI dev server. Install it on a Mac Mini, a Linux box, or a cloud VM. Spin up agents, close your laptop, and check back from your phone — they keep working.
- Desktop app — full workspace UI on macOS
- Web browser — open app.deusmachine.ai from any computer
- Phone — monitor agents, review results, send messages on the go
- Slack — send tasks and check status without leaving chat (coming soon)
Your code stays on your machine. You bring your own API key and pay Anthropic or OpenAI directly. No per-seat fees. No vendor cloud. Open source, MIT licensed.
-
Parallel workspaces — run multiple agents at once. Each gets its own git branch, terminal, and browser — fully isolated, zero conflicts.
-
Built-in browser — agents can open pages, click, take screenshots, and verify their own work. No separate Playwright/Puppeteer setup needed.
-
Terminal access — each workspace gets a full terminal. Agents run commands, install packages, run tests, and read the output in real time.
-
Live diffs — see exactly what each agent is editing as it works, across all workspaces simultaneously.
-
Claude Code + Codex — works with Anthropic's Claude Code and OpenAI's Codex. Bring your own API key.
-
Monitor from your phone — start agents on your server, check progress from any browser. Go to dinner, check your phone, three features are done.
-
Extensible — add MCP servers, hooks, or your own scripts to customize each workspace.
Desktop app (recommended) — download for macOS from GitHub Releases.
Linux packaged desktop builds are disabled until the native packaged runtime and bundled agent CLIs are staged and verified for Linux. Use the CLI or web app for Linux servers today.
CLI on any machine — one command:
npx deus-machineFirst launch walks you through setup. The packaged macOS app includes the native Claude and Codex agent CLIs it needs; bring an API key or provider login from Anthropic or OpenAI.
Point Deus at a repo, describe a task, and the agent gets to work. Open more workspaces to run more tasks in parallel.
No account required. Your API key, your machine, your code.
Is it free?
Yes. Deus is open source (MIT). You bring your own API key and pay for token usage directly with Anthropic or OpenAI.
What agents does it support?
Claude Code (Anthropic) and Codex (OpenAI). Adding new agents requires implementing the
AgentHandler interface in the agent server.
Does my code leave my machine?
No. Agents run locally. API calls go directly from your machine to Anthropic/OpenAI. The only external connection is the optional relay for remote access — it forwards WebSocket frames without storing them. The relay source code is in this repo. You can self-host it or disable remote access entirely.
How is this different from Conductor, Devin, or Cursor?
Conductor is a Mac desktop app for running parallel agents locally. Deus is an AI dev server — it runs on any machine (Mac, Linux, cloud VM) and you connect from a desktop app, your phone, a browser, or Slack. If you want a polished Mac-native experience, Conductor is great. If you want a server you can access from anywhere on hardware you choose, that's what Deus is built for.
Devin and Cursor background agents run on cloud infrastructure — your code goes to their servers. Deus runs entirely on your own hardware.
Can I run it on a remote server?
Yes — that's a first-class use case. Run
npx deus-machine on any server, then connect from your laptop or phone via app.deusmachine.ai. No inbound ports needed.
Deus is pre-1.0 software (currently v0.3.x). Under active development.
Works well: parallel workspaces with git isolation, Claude Code and Codex integration, real-time diffs and terminal streaming, headless server mode, mobile web pairing.
Coming soon: native mobile app, Slack integration.
Known limitations: single-user only (no team accounts or SSO yet), no built-in API cost tracking, no Windows desktop app (CLI works on WSL).
Architecture
Three processes, all on your machine:
┌─────────────────────────────────────────────────────────┐
│ Frontend (React) │
│ Desktop: Electron / Web: app.deusmachine.ai │
└──────────┬──────────────────────────────┬───────────────┘
│ WebSocket │ Electron IPC
│ (subscriptions, commands) │ (native-only)
┌──────────▼──────────────────────────────▼───────────────┐
│ Backend (Node.js + Hono) │
│ All business logic: SQLite, git worktrees, file │
│ watching, PTY, agent event persistence, WS push │
└──────────┬──────────────────────────────────────────────┘
│ JSON-RPC 2.0 over WebSocket
┌──────────▼──────────────────────────────────────────────┐
│ Agent Server (Node.js) │
│ Stateless. Wraps Claude Code + Codex SDKs. │
│ Separate process for crash isolation. │
└─────────────────────────────────────────────────────────┘
All data lives in a local SQLite database. The agent server is stateless — if it crashes, the backend survives. Remote access uses an optional outbound WebSocket tunnel to a Cloudflare Worker relay (no inbound ports needed). The relay forwards frames without inspecting or storing them — source code included.
Instructions for contributors
git clone https://github.com/zvadaadam/deus-machine.git
cd deus-machine
bun install
bun run dev # Desktop: Electron + backend + agent-server
bun run dev:web # Web: backend + frontend (no Electron)Requires Node.js 22+ and Bun 1.2+. Do not use npm or yarn for installation.
See CONTRIBUTING.md for development setup and CLAUDE.md for architecture details.
- Discord — questions, setups, bugs
- GitHub Issues — bug reports and feature requests
- GitHub Discussions — ideas and show-and-tell