GitHub - preset-io/agor: Orchestrate Claude Code, Codex, and Gemini sessions on a multiplayer canvas. Manage git worktrees, track AI conversations, and visualize your team's agentic work in real-time.

Team command center for all things agentic.

Agor is a shared canvas where coding agents (Claude Code, Codex, Gemini) and long-lived assistants run side-by-side on isolated git worktrees — the anchor entity where sessions, dev environments, prompts, and PRs converge. Your whole team rallies around the same live work in real time, and the agents themselves drive Agor over MCP.

• Team workspace for AI agents — multiplayer is the core differentiator. Live cursors, facepile, scoped comments, shared sessions and dev envs.
• Worktrees as the anchor — one entity per piece of work, where conversations + dev env + PR + prompts all converge.
• Multi-agent, multi-runtime — Claude Code, Codex, Gemini, OpenCode, Copilot, interchangeable per session.
• Shared, long-lived assistants — persistent agents with identity, memory, and skills that you publish for the whole team.
• Self-hosted — your repos, your DB, your isolation posture.

📖 Read the full documentation at agor.live →

See It In Action

Spatial canvas with worktrees and zones	Rich web UI for AI conversations
MCP servers and worktree management	Live collaboration with cursors and comments

→ Watch unscripted demo on YouTube (13 minutes)

Quick Start

Requires Node.js ≥ 22.12 (install).

npm install -g agor-live
agor init           # creates ~/.agor/ and database
agor daemon start   # runs in the background
agor open           # opens the UI

That's it. Visit agor.live/guide/getting-started to add a repo and create your first session — the onboarding wizard takes it from there.

For Docker, source builds, Postgres, and team setups, see Extended Installation.

What is Agor?

Agor is built on three foundational concepts:

• Worktrees — the unit of work. A git worktree pinned to a board, with its own branch, isolated environment, and conversations.
• Sessions & Trees — agent conversations with genealogy. Fork to explore alternatives, spawn subsessions for focused subtasks.
• Boards & Zones — a Figma-style 2D canvas of worktrees. Drop a worktree into a zone to trigger a templated prompt.

Everything else builds on these. Read the Features Overview →

Features

• Assistants — long-lived AI companions with file-based memory and skills, OpenClaw-style.
• Agor MCP Server — anything a user can do in Agor, an agent can do too. Sessions are auto-issued an MCP token.
• Rich Chat UX — per-prompt token + dollar accounting, model/effort selectors, structured tool blocks, completion chimes.
• Multiplayer & Social — live cursors, facepiles, spatial comments, shared multiplayer terminal.
• Environments — one-click dev servers per worktree with auto-managed unique ports.
• Scheduler — cron-style triggers for templated prompts. Powers assistant heartbeats and automated audits.
• Cards (Beta) — generic workflow entities for non-code workflows.
• Artifacts — live, interactive applications rendered on the board via Sandpack.
• Message Gateway — Slack and GitHub as portals to Agor sessions.

Screenshots

Task-centric conversation UI	MCP server and worktree management
Zone trigger modal on session drop	Zone trigger configuration
Worktree environment setup	Session creation with agent selection
Built-in terminal with worktree context	Welcome screen showing team status

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/>/mcp?sessionToken=..."]
        Services["Services<br/>Sessions, Tasks, Messages<br/>Boards, Worktrees, Repos"]
        AgentSDKs["Agent SDKs<br/>Claude, Codex, Gemini"]
        ORM["Drizzle ORM"]
    end

    subgraph Storage
        DB[("LibSQL Database<br/>~/.agor/agor.db")]
        Git["Git Worktrees<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 --> AgentSDKs
    AgentSDKs -.->|JSON-RPC 2.0| MCP

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

Full Architecture Guide →

Development

Development Guide →

Quickest path — run Agor from source via Docker:

git clone https://github.com/preset-io/agor.git
cd agor
docker compose up

The repo's .agor.yml defines variants (sqlite / postgres / full / docs) so you can spin up the exact dev setup you need. The dev guide also covers running Agor inside Agor for dogfooding, plus custom builds via packages/agor-live/build.sh.

Roadmap

View roadmap on GitHub →

Highlights:

• Match CLI-Native Features — SDKs are evolving rapidly and exposing more functionality. Push integrations deeper to match all key features available in the underlying CLIs
• Bring Your Own IDE — Connect VSCode, Cursor, or any IDE directly to Agor-managed worktrees via SSH/Remote
• Unix User Integration — Enable true multi-tenancy with per-user Unix isolation for secure collaboration. Read the guide →

Community

• Discord - Join our Discord community for support and discussion
• GitHub Discussions - Ask questions, share ideas
• GitHub Issues - Report bugs, request features

About

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

Read the story: Making of Agor →