~/guides/OPENBOT.md

Guides / AI tools

OpenBot: the free desktop app that turns Claude, Codex and Gemini into a team of AI colleagues, each on its own project

Each agent gets its own workspace, a task queue and agent-to-agent messages and files. Install, first agent, queue basics, full-access and licence caveats.

Watch the reel on InstagramComment #OPENBOT to get this guide

One Claude Code window, one Codex window, one Gemini tab, each chatting on its own and stepping on each other's files. This is the full version of my OPENBOT reel: OpenBot, a free desktop app on GitHub, puts those agents into one workspace where each runs its own project, tasks queue up and work is handed over. Install steps, features and the licence were checked against the official README and site on 2026-11-18; I did not install it myself, and the last section says why.

01What you get: a team of AI colleagues on one computer

Reel frame: openbot.run on the wall screen, Codex, Claude and Gemini ringed, Claw'd beside it
Reel frame: the official site says Run Codex, Claude, Gemini, Grok, free for personal use.

OpenBot is a desktop app (macOS, Windows, Linux) by nightly-labs with its source public on GitHub. It puts agents such as Claude Code, Codex and Gemini into one workspace. Once installed you have:

  1. A workspace folder and a conversation per agent, each on its own project, so they never overwrite each other's files.
  2. A task queue: drop work in, it runs in order; pause, resume and cancel on the same screen.
  3. Agent-to-agent messages and file transfers, so one finishes and hands over to the next; or a shared channel with one agent as task owner delegating.
  4. A built-in browser the agents can open, inspect and control themselves.
The nightly-labs/openbot repo page on GitHub: Star 8.7k and the About text
The official repo (captured 2026-11-18): 8.7k stars, a local-first desktop workspace for AI teammates.

02Install: Mac, Windows and Linux

Installers live on GitHub Releases (openbot.run/download points to the same place). Requirements per the README: macOS 13 or newer (Apple silicon or Intel), Windows 10 or newer on x64, Linux as an AppImage (x64 or arm64).

  1. Mac: download OpenBot-*-arm64.dmg (x64.dmg on an Intel Mac), drag it to Applications and open it.
  2. Windows: download OpenBot-*-x64.exe, run the installer, open OpenBot.
  3. Linux: download OpenBot-*-x86_64.AppImage, chmod +x it and run it. On Ubuntu 23.10+ and Debian 13 install the AppArmor profile from the README first.
  4. The first launch asks you to consent to full agent access; read the Good to know section below before you click.
openbot.run/download: Download OpenBot, Free for Mac, Windows and Linux, with macOS, Windows and Linux cards below
The official download page: three platforms, plus iPhone and Android apps.

03Create your first agent and its workspace

The README describes prompt-driven creation: you describe the agent's role and rules, OpenBot generates its name, avatar and instructions, you review each section and save. Each agent is tied to one provider (Claude, Codex, Gemini...) and its own workspace. I did not install and run it myself; the steps below follow the README.

  1. Open OpenBot, add an agent and describe what it is responsible for in a paragraph (you can paste the one below).
  2. Review the instructions it generates, remove what you don't want, save.
  3. Pick the provider: for Claude choose Claude Code (OpenBot downloads the CLI, or uses the one you already have) and sign in; same for Codex and Gemini. Gemini needs a Google AI Pro or Ultra plan.
  4. Point this agent's workspace at one project folder. Open a second agent for another project; each keeps to its own.
Role description for your first agent (paste into the add-agent box)
You are the front-end engineer of [project name]. Your workspace is [project folder path].
Rules:
1. Only change files inside this folder; read README and package.json before you start.
2. After each task, report in three lines: what changed, how you verified it, what risks remain.
3. When you need backend data, message the backend agent "[backend agent name]" instead of guessing the API.
4. Never delete files, change git settings or install global packages.
Reel frame: three paper cards Claude, Codex, Gemini, each with its own folder, three 2D characters below
Reel illustration (not the app): three agents, three workspaces.

04Queue, messages between agents, built-in browser

These three are listed under What works in the README, and they are the biggest difference from a pile of separate chat windows.

The What works list in the GitHub README, the embedded-browser line highlighted
What works in the official README (captured 2026-11-18).
  1. Queue: tasks you give an agent sit in a FIFO queue with pause, resume and cancel, and survive a crash.
  2. Hand-off: agents send each other messages, replies, images and files; a shared channel has one task owner who can delegate explicitly, with Stop, Resume and Reassign.
  3. Browser: the app has a persistent browser that agents open, inspect and control; letting them drive the whole computer (Computer Use) is a separate option, off by default.
  4. Each agent has its own model and reasoning setting, and long threads are compacted automatically.
Reel frame: an envelope and a folder fly from the Claude desk to the Codex desk, done tick, task 1 ticked above
Reel illustration (not the app): one finishes, the next one takes over.

05Good to know

The Warning box in the GitHub README: Agents run with danger-full-access and approvalPolicy: never
The warning box in the official README, verbatim.
  1. Full access by default, no per-step confirmation: the README says agents run with danger-full-access and approvalPolicy: never; after the first consent they read and write files, run commands, use the network and drive the browser without asking. Keep backups, run only agents and tasks you trust, keep projects in git.
  2. The licence is not open source: PolyForm Noncommercial 1.0.0, free for personal, non-commercial use with public source; commercial use needs a separate licence (Starter or Team under Settings → Billing). Only versions up to 0.1.11 were Apache-2.0.
  3. Local-first is not offline: your data stays on your machine, but each agent still calls its own provider (Claude to Anthropic, Codex to OpenAI, Gemini to Google), and their quotas and costs apply.
  4. Versions change almost daily, so menus and steps may differ from this page; everything here follows the README as of 2026-11-18. Re-read Releases and the README before installing.
  5. All app visuals here are official page screenshots and my illustrations; I did not install or run it on this computer.
Reel frame: a red sign reads runs without confirming by default, with Back up first and non-commercial licence stamps
Reel frame: back up first, run only what you trust, non-commercial licence.

Sources

Related guides