README

OpenBot




OpenBot is a local-first desktop workspace for persistent AI teammates. It supports the local
Codex App Server and
Claude Code, plus Grok CLI,
OpenCode, Gemini, Cursor CLI, Cline CLI, Kimi Code CLI,
Devin CLI, GitHub Copilot CLI, Mistral Vibe, and Hermes Agent through ACP. It gives every agent its own workspace and
conversation, and provides local queues, file transfers, an embedded browser, and agent-to-agent
messaging in one desktop app.

OpenBot is ready for production use. A new release ships almost every day.

 [!WARNING]
 Agents run with danger-full-access and approvalPolicy: never. They can read and modify files,
 run commands, use the network, and control the embedded browser without per-action confirmations
 after the explicit first-launch consent.
 Run only agents and tasks you trust, keep backups, and review Security before use.

 What works

- Prompt-driven agent creation and editing on desktop and mobile, with editable instructions, avatar, and section review before saving.
- Persistent agents backed by independent Codex, Claude, Grok, OpenCode, Gemini, Cursor, Cline, Kimi, Devin, GitHub Copilot, Mistral, or Hermes sessions and local workspaces.
- Custom OpenAI-compatible endpoints and custom ACP agents, with detection of local model servers (Ollama, LM Studio) and installed agents.
- Per-agent context monitoring with automatic compaction before long threads exhaust the model window.
- FIFO message queues with pause, resume, cancellation, and crash-safe persistence.
- Agent-to-agent messages, replies, reactions, images, and managed file transfers.
- Shared desktop channel chats with one task owner, explicit delegation, shared history, and Stop, Resume, Reassign, Archive, and Restore controls.
- A persistent embedded browser that agents can open, inspect, and control.
- Optional Computer Use on macOS, Windows and Linux through the cua-driver binary in the release, which OpenBot starts as its own child process and gives to every provider.
- Per-agent model, reasoning, profile, notification, browser, and panel state.
- Local data and privacy-safe diagnostics exports from the account menu.
- Optional OpenBot accounts through one-time email codes. The account API runs on Cloudflare Workers and D1.

OpenBot is local-first, not offline-only. Codex connects to OpenAI, Claude connects to Anthropic,
Grok connects to xAI, Gemini connects to Google, Cursor connects to Cursor, Cline connects to Cline,
Kimi connects to Moonshot AI, Devin connects to Cognition, GitHub Copilot connects to GitHub, Mistral connects to Mistral AI, Hermes connects to Nous Portal and to the providers you set up in Hermes,
visited pages use the network, and installed plugins may connect to their own services.

 Install

OpenBot supports macOS 13 or newer on Apple silicon or Intel, Windows 10 or newer on x64 systems, and x64
or arm64 Linux as an AppImage.

 macOS

1. Download the latest OpenBot--arm64.dmg (or OpenBot--x64.dmg on an Intel Mac) from GitHub Releas

Top issues

Discussions

Latest release

What's Changed
 Let users choose the spoken replies model: Supertonic, ElevenLabs or xAI by @NorbertBodziony in https://github.com/nightly-labs/openbot/pull/5555
 Show which workflow branch has no answer at a model join by @NorbertBodziony in https://github.com/nightly-labs/openbot/pull/5561
 Start dev builds with the Dynamic Island and agent dock off by @NorbertBodziony in https://github.com/nightly-labs/openbot/pull/5562
 Add a setting to turn off the hold to quit on a Mac by @NorbertBodziony in https://github.com/nightly-labs/openbot/pull/5566
 Use API credit for Claude agents on an Anthrop