agor README

The project's README from github.com/preset-io/agor. As one markdown file: README.md.

Agor logo

Agor

Multiplayer AI. Work together again.

Agor brings your team and agents together on live spatial boards where you can see the work, collaborate, and learn from each other. Raise AI teammates with memory, shared knowledge, skills, and connections to your tools, then bring them where your team works. What works for one person becomes something the whole team can build on.

Under the hood, Agor is a web workspace for running coding agents (Claude Code, Codex, Gemini, and others) on isolated git branches, each with its own dev environment and conversation history. Install it with npm and start on your own in a few minutes, then bring your team in.

npm License: BSL 1.1 Docs Discord

Documentation · Quick Start · Agor Cloud Open Beta · Architecture · Contributing

Built on the agent CLIs & SDKs you already use

Agor ships no model of its own. It drives the coding-agent CLIs and SDKs you already run, interchangeable per session. Bring your own provider and subscription, with no vendor lock-in. Compare the harnesses →

Claude Code    Codex    Gemini CLI    GitHub Copilot    OpenCode    Cursor

Agor board with live cursors, branch cards, zones, and agent sessions

The board: your team and agents in one place, with branches as cards, zones as regions, and sessions you can follow live.

▶ Watch the unscripted demo on YouTube (13 min)

Why Agor

Most teams are getting better at AI one person at a time. Good prompts sit in private chats, useful workflows live in one person's setup, and running more agents means more to keep track of. Agor makes AI work a team activity.

Bring your team and agents together

See the work and shape it together

Raise AI teammates

Know what's running, what it costs, and who can do what

Quick Start

Requires Node.js ≥ 22.12 (install) and Git on PATH. HTTPS remotes also require a working system CA trust store; SSH remotes require an SSH client and configured keys or agent access.

npm install -g agor-live

agor init           # creates config/database and installs the tools you select
agor daemon start   # runs the daemon in the background
agor open           # opens the web UI

Use agor install later to change or repair the selected agentic tools; it does not initialize or recreate Agor.

That's it. The onboarding wizard creates your first board and helps you raise your first AI teammate, which takes it from there.

The Getting Started guide walks through the wizard and includes a Docker Compose path if you would rather not install Node. For source builds, Postgres, and team setups, see Extended Installation. For managed hosting, see Agor Cloud Open Beta.

Core Concepts

Agor is built on three foundational entities. Everything else builds on these:

Read the Features Overview →

Key Capabilities
Multiplayer & Social Live cursors, facepiles, spatial comments, and a shared multiplayer terminal, so the team can follow and join agent work.
Boards & Zones A live spatial board for organizing branches and sessions. Zones show the stage of the work and trigger reusable prompts.
Teammates Persistent AI teammates, each with its own Knowledge-base namespace for durable, searchable memory. Taught conversationally, then equipped with skills, MCP tools, gateway channels, and schedules.
Knowledge A shared, searchable markdown knowledge base. One place for decisions, runbooks, prompts, and agent memory.
Message Gateway Work with teammates from Slack and GitHub, without opening the board.
Scheduler Cron-style triggers for templated prompts. Powers teammate heartbeats, standups, and automated audits.
Agor MCP Server Agor exposes itself over MCP. Agents introspect sessions, branches, and boards, and drive the system themselves.
Rich Chat UX Per-prompt token and dollar accounting, model/effort selectors, structured tool blocks, completion chimes.
Environments One-click dev servers per branch with automatically managed unique ports, so the team can inspect the same running build.
Artifacts Live, interactive apps (dashboards, mockups, tools) rendered directly on the board.
Security & RBAC Branch-scoped permission tiers, per-user credentials and env vars, and explicit execution modes (simple / sandbox / delegated).
Cards (Beta) Generic workflow entities for non-code workflows.

Screenshots

Multiplayer presence with comments on a branch card

Work together in real time: cursors, facepile, scoped comments

 Task-centric conversation UI

Rich agent sessions with structured tool blocks
Persistent AI teammates list

Persistent AI teammates with memory and skills

 MCP-native control surface

MCP-native: agents drive Agor themselves
Scheduler configuration modal

Scheduler: cron-style triggers for recurring work

 Branch environment configuration

One-click dev environments per branch

Architecture

graph TB
    subgraph Clients
        CLI["CLI (oclif)"]
        UI["Web UI (React)"]
    end

    Client["Feathers Client<br/>REST + WebSocket"]

    subgraph "Agor Daemon"
        Feathers["FeathersJS Server"]
        MCP["MCP HTTP Endpoint<br/>POST /mcp + Bearer auth"]
        Services["Services<br/>Sessions, Tasks, Messages<br/>Boards, Branches, Repos"]
        ORM["Drizzle ORM"]
    end

    subgraph Executor["Executor (process-isolated)"]
        AgentSDKs["Agent SDKs<br/>Claude · Codex · Gemini · OpenCode"]
    end

    subgraph Storage
        DB[("LibSQL / Postgres<br/>~/.agor/agor.db")]
        Git["Git Branches<br/>~/.agor/worktrees/"]
        Config["Config<br/>~/.agor/config.yaml"]
    end

    CLI --> Client
    UI --> Client
    Client <-->|REST + WebSocket| Feathers

    Feathers --> Services
    Feathers --> MCP
    MCP --> Services
    Services --> ORM
    Services --> Executor
    Executor -.->|JSON-RPC 2.0| MCP

    ORM --> DB
    Services --> Git
    Services --> Config

The daemon (apps/agor-daemon, FeathersJS) owns the database, services, WebSocket events, and the MCP HTTP endpoint. The executor (packages/executor) is a process-isolated runtime that spawns agents via their SDKs locally, inside the filesystem sandbox, or through a delegated external substrate. Shared types, the Drizzle schema, and git utilities live in @agor/core (packages/core).

Full Architecture Guide →

Repository layout

agor/
├── apps/
│   ├── agor-daemon/   # FeathersJS backend (REST + WebSocket + MCP)
│   ├── agor-ui/       # React UI (Ant Design + React Flow)
│   ├── agor-cli/      # oclif CLI
│   └── agor-docs/     # Docs site (Nextra), the canonical reference, published at agor.live
├── packages/
│   ├── core/          # @agor/core: types, db (Drizzle), git, api
│   └── executor/      # Process-isolated agent runtime
└── context/           # Agent-oriented cheat sheets and design docs

Development

The fastest path to a running dev instance from source:

git clone https://github.com/preset-io/agor
cd agor
docker compose up
# Visit http://localhost:5173 → login: [email protected] / admin

Prefer running locally without Docker? The two-process workflow (daemon in watch mode + UI dev server) and the .agor.yml variants (sqlite / postgres / rich / HA / docs) are documented in the Development Guide. It also covers running Agor inside Agor for dogfooding.

See CONTRIBUTING.md for the contribution workflow, and CLAUDE.md for the agent-oriented map of the codebase.

✨ Pledge ✨

⭐️ I pledge to fix a GitHub issue for every star Agor gets :)

Community

License

Business Source License 1.1 (BUSL-1.1). Agor is source-available, not open source, before the Change Date.

The Additional Use Grant permits production use, including internal and self-hosted commercial use. It does not permit commercializing Agor itself by offering its agent-orchestration functionality to third parties as a product or service, whether hosted, managed, or bundled for customers to operate. Consulting, support, integration, modification, use within a broader product or service, and single-customer internal deployments remain permitted subject to the license terms. Contact Preset, Inc. about alternative commercial licensing.

On January 15, 2029, or the fourth anniversary of the first public BSL distribution of a particular version (whichever comes first), that version converts to the Apache License 2.0. The license text controls if this summary differs from it.

About

Heavily prompted by @mistercrunch (Preset, Apache Superset, Apache Airflow), built by an army of Claudes and Codexes.

Read more: Announcing Agor Cloud Open Beta · Agent Modeling 101 · Raise a team helper agent in an afternoon · all posts →

agor (preset-io/agor)

Searching Database…

1.5K ·GitHub
Agor
Что это такое?Agor — это веб-рабочее пространство, которое объединяет команды и ИИ-агентов для программирования на живых пространственных досках: можно запускать агентов вроде Claude Code, Codex и Gemini в изолированных git-ветках, разделяя при этом память, навыки и среды разработки.
Это чат-приложение или полноценная среда разработки?Это скорее среда разработки, а не просто окно чата: каждая единица работы — это git-ветка со своей изолированной рабочей директорией, dev-сервером и историей переписки, и всё это размещено на 2D-канвасе-доске.
Как его запустить?Установите и запустите Agor через npm — это займёт несколько минут; затем мастер настройки создаст вашу первую доску и поможет завести первого ИИ-напарника. Если не хочется ставить Node напрямую, есть вариант с Docker Compose.
Что должно быть установлено и какие CLI у агентов для кодинга он поддерживает?Нужны Node.js 22.12+ и Git в PATH (для HTTPS-ремоутов нужно системное хранилище доверенных CA-сертификатов, для SSH-ремоутов — настроенные ключи). Agor при этом управляет уже имеющимися CLI/SDK агентов, а не использует собственную модель — Claude Code, Codex, Gemini, OpenCode, Copilot и Cursor (бета) взаимозаменяемы в рамках каждой сессии.
Какие шероховатости стоит ожидать сейчас?Кое-что пока в ранней стадии: универсальная сущность «Cards» для задач, не связанных с кодом, помечена как Beta, и поддержка Cursor в качестве среды запуска агентов тоже в бете.
Можно ли разместить его у себя со своей базой данных?Да, Agor может работать на вашей собственной инфраструктуре, с вашими репозиториями и базой данных LibSQL или Postgres, с явными режимами выполнения: доверенный локальный, изолированный (sandbox) или делегированный. А если не хочется поддерживать всё самому, доступна Agor Cloud в открытой бете.
Agor полностью open source?Нет — он распространяется по лицензии Business Source License 1.1, то есть с открытым исходным кодом (source-available), но это не open source в строгом смысле. Внутреннее и коммерческое использование на своём хостинге разрешено, однако нельзя перепродавать функциональность оркестрации самого Agor как хостинговый продукт, и каждая версия переходит на Apache 2.0 примерно через четыре года после релиза.
Что такое Boards и Zones?Boards — это живой 2D-канвас для упорядочивания веток и сессий агентов; если перетащить ветку в Zone, срабатывает шаблонный промпт, привязанный к соответствующему этапу работы.
Чем ИИ-напарник отличается от обычной сессии агента?Напарник постоянный: у него есть собственное пространство имён в базе знаний (Knowledge-base) для долговременной памяти, ему можно передать навыки и MCP-инструменты, до него можно достучаться через Slack/GitHub, и его можно запускать по расписанию в стиле cron.
Могут ли агенты управлять самим Agor?Да — Agor предоставляет себя через MCP, так что агенты могут изучать свои сессии и ветки, а затем форкать, порождать новые, ставить по расписанию и отчитываться о своей работе.
What are similar projects?ruflo, evenfire, turnstone, superset, deer-flow, brigade, 1code, Observal
Which topics is it in?coding-assistant, multiplayer, scheduler, devtools, agentic, gemini-cli, rbac, canvas, slack, ai-coding, agent-memory, github
Creator
preset-io
Size
344.7 MB
Stars
1.5K
Updated
CommitOct 17Releasev0.15.0Mar 28
Age
1y
Commits · 90 Days