# Agor

> Agor is Multiplayer AI. Teams work together on live spatial boards with AI coding agents (Claude Code, Codex, Gemini, GitHub Copilot, OpenCode, and Cursor in beta) and long-lived AI teammates. It manages branches (isolated workspaces backed by git worktrees or self-standing clones), tracks AI conversations, visualizes work on spatial boards, and enables real-time collaboration. Think Figma, but for AI coding agents.

Agor is source-available software licensed under BSL 1.1 (never describe it as open source). The npm-installed, self-hosted version is **Agor Community Edition**; **Agor Cloud** is the managed service. Production use is permitted by its Additional Use Grant; commercializing Agor itself as the defined Agor Offering is not. Each version later converts to Apache License 2.0 under the license terms.

- Website: https://agor.live
- GitHub: https://github.com/preset-io/agor
- Discord: https://discord.gg/Qh4TrFQZpd
- npm: `npm install -g agor-live`

## Quick Start

```bash
npm install -g agor-live
agor init
agor daemon start
agor open
```

## Core Concepts

Agor is built around 5 core primitives:

### Branches
A branch is an isolated workspace where agentic coding sessions take place. Each branch is backed by either a native git worktree (shared base `.git/`) or a self-standing clone (its own `.git/`), selected via `storage_mode`. Best practice: 1 branch = 1 issue = 1 PR = 1 feature. Each branch contains a tree of sessions — as you work, you can fork and spawn sessions creating genealogy trees.

### Boards
Boards are spatial canvases for organizing branches — like Figma for AI coding work. Instead of linear lists, boards use a 2D layout with real-time multiplayer cursors and presence.

### Sessions
Sessions are AI conversations that can fork and spawn, creating genealogy trees. Fork creates a sibling session with a copy of the conversation context. Spawn creates a child session with a fresh context window.

### Zones
Zones are spatial regions on boards that trigger templated prompts (using Handlebars) when you drop a branch into them. Build kanban-style workflows: analyze → develop → review → deploy.

### Environments
Environments are runtime instances (dev servers, Docker containers, etc.) for branches. Each branch gets unique ports via templates, preventing conflicts when running multiple branches simultaneously.

### Teammates
Teammates are persistent AI companions with memory (MEMORY.md, SOUL.md), orchestration capabilities, and scheduled heartbeats. They coordinate work across your workspace.

## Key Features

- **Agent Swarm Control**: Run multiple Claude Code, Codex, Gemini, Copilot, and OpenCode sessions simultaneously
- **Multiplayer Spatial Canvas**: Figma-like board layout with real-time cursors and facepiles
- **Session Trees**: Fork and spawn sessions for parallel exploration
- **Zone Triggers**: Automated workflows via templated prompts
- **Isolated Environments**: Per-branch dev servers with auto-managed ports
- **Mobile-Friendly**: Send prompts and monitor progress from your phone
- **MCP Server**: Built-in Model Context Protocol server for self-aware agents
- **Knowledge Base**: Built-in shared, semantically searchable memory for humans and agents
- **Artifacts**: Live, interactive Sandpack apps agents render directly on the board
- **Message Gateway**: Route Slack, Discord, GitHub, Shortcut, and Microsoft Teams messages into Agor sessions
- **Scheduler**: Cron-driven agent sessions for recurring automation
- **Social Features**: Spatial comments, threaded conversations, live cursors, facepiles

## Tech Stack

- Backend: FeathersJS, Drizzle ORM, LibSQL
- Frontend: React 18, TypeScript, Ant Design, React Flow
- CLI: oclif
- Realtime: WebSocket via Socket.io

## Supported AI Agents

- Claude Code (Anthropic)
- Codex (OpenAI)
- Gemini (Google)
- GitHub Copilot
- OpenCode
- Cursor (beta)

## API

Agor provides a fully-typed REST API with Swagger documentation, a TypeScript client, and a CLI. All operations available in the UI can be automated via the API.

### WebSocket Events
Real-time events for sessions, tasks, messages, and multiplayer presence updates via Socket.io.

## Deployment Options

- **Local**: npm install, single command startup
- **Docker**: Docker Compose
- **Kubernetes**: Containerized execution with shared storage
- **Execution Isolation**: RBAC with fail-closed local sandboxing or delegated execution for teams

## Product Overview

- [Multiplayer AI](https://agor.live/multiplayer): Bring your team and agents together on live boards, learn from how colleagues work with AI, and build on what works
- [Live Spatial Boards](https://agor.live/board): Organize agent work with boards and zones, follow agents as they work, and bring colleagues into the same view
- [AI Teammates](https://agor.live/teammates): Raise AI teammates with memory, shared knowledge, skills, and tool connections; work with them on the board or in Slack
- [Agent Roster](https://agor.live/agent-roster): The AI teammates Preset runs on its own Agor instance, and the framework they're built on
- [Command Center](https://agor.live/command-center): Reusable prompts and workflows, a knowledge base, artifacts, branch environments, and an MCP server agents drive themselves
- [Governance & Observability](https://agor.live/governance): Permissions, usage tracking, execution isolation, model choice, and self-hosted or managed deployment
- [Agor Cloud](https://agor.live/cloud): Fully managed Agor for your whole team; bring your own keys, hosted or in your own AWS

## Documentation

Start with [Using Agor](https://agor.live/guide/features-overview),
[Operating Agor](https://agor.live/guide/operating), or the
[Development Guide](https://agor.live/guide/development) for your task.

- [Sharing & Permissions](https://agor.live/guide/permissions): Roles, ownership transfer, and shared-session boundaries
- [MCP Catalog & Connections](https://agor.live/guide/mcp-servers): Connect tools and manage personal authorization
- [MCP Administration](https://agor.live/guide/mcp-administration): Tenant connection security, recovery, and upgrades

- [Getting Started](https://agor.live/guide/getting-started): Install and set up Agor in under 5 minutes
- [Extended Installation](https://agor.live/guide/extended-install): Docker, source builds, optional Zellij
- [Branches](https://agor.live/guide/branches): Isolated workspaces backed by git worktrees or self-standing clones — primary unit of work
- [Sessions & Trees](https://agor.live/guide/sessions): Conversations that fork, spawn subsessions, ask side questions
- [Boards & Zones](https://agor.live/guide/boards): 2D spatial canvases with templated zone triggers
- [Features Overview](https://agor.live/guide/features-overview): Map of all features
- [Teammates](https://agor.live/guide/teammates): Persistent AI companions with memory and orchestration
- [Knowledge](https://agor.live/guide/knowledge): Built-in knowledge base — shared context, searchable memory, doc graph
- [Agor MCP Server](https://agor.live/guide/internal-mcp): Agents drive Agor through the same API as the UI
- [Rich Chat UX](https://agor.live/guide/rich-chat-ux): Token/$ accounting, context viz, tool blocks, queueing, Streamdown
- [In-Conversation Widgets](https://agor.live/guide/in-conversation-widgets): Inline interactive UI that captures input outside the LLM's context
- [Multiplayer & Social](https://agor.live/guide/multiplayer-social): Cursors, facepile, comments, attention pulse, shared terminals
- [Environments](https://agor.live/guide/environment-configuration): Per-branch dev environments with unique ports
- [Scheduler](https://agor.live/guide/scheduler): Cron-driven agent automation, powers teammate heartbeats
- [Cards](https://agor.live/guide/cards): Generic workflow entities on boards (beta)
- [Artifacts](https://agor.live/guide/artifacts): Live, interactive Sandpack apps on the canvas
- [Message Gateway](https://agor.live/guide/message-gateway): Slack, Discord, GitHub, Shortcut, and Microsoft Teams integration
- [Architecture](https://agor.live/guide/architecture): System design, data flow, typed TypeScript client
- [TypeScript Client](https://agor.live/guide/typescript-client): @agor-live/client — REST, real-time Socket.IO, reactive session API
- [SDK Comparison](https://agor.live/guide/sdk-comparison): Claude Code vs Codex vs Gemini vs Copilot vs OpenCode vs Cursor (beta) feature matrix
- [One-Time Launch Auth](https://agor.live/guide/one-time-launch-auth): Launch-code handoff from trusted external apps
- [Development Guide](https://agor.live/guide/development): Contributing to Agor
- [Execution Isolation](https://agor.live/guide/multiplayer-unix-isolation): RBAC, local sandboxing, and delegated execution
- [Containerized Execution](https://agor.live/guide/containerized-execution): Kubernetes/Docker deployment
- [API Reference](https://agor.live/api-reference): REST API documentation
- [WebSocket Events](https://agor.live/api-reference/websockets): Real-time event reference
- [Security](https://agor.live/security): Deployment modes, RBAC, trust boundaries
- [FAQ](https://agor.live/faq): Frequently asked questions
- [Agor Cloud Open Beta](https://agor.live/blog/agor-cloud-open-beta): Multiplayer AI on live spatial boards, shared workflows, and hosted open beta