GuideGetting Started

Getting Started

Install Agor, open the UI, and follow the onboarding wizard. Your first assistant will help you get your bearings and get everything else set up.

Install

Requires Node.js ≥ 22.12 (install).

npm install -g agor-live

Run

agor init           # creates ~/.agor/ and database
agor daemon start   # runs in the background
agor open           # opens the UI in your browser

Follow the onboarding wizard

The first time you open the UI, the Onboarding Wizard runs. It picks between cloning the assistant framework repo or pointing at one of your own, then walks through Clone → Board → Worktree → API Keys → Launch and drops you into a live session.

Onboarding: Welcome — Set up your assistant or use your own repoOnboarding: Worktree — name a personal branchOnboarding: API Keys — pick an agent and paste a key (or skip)Onboarding: Launch — your assistant is ready

Once you’re in the session, your assistant introduces itself — asks for a name and emoji, who you are, and what you’d like to get started on. From there it can register more repos, set up boards, structure a workflow, or just be a thinking partner. Anything a user can do in Agor, the assistant can do too — it has full access to the Agor MCP Server.

Customize your install

Agor runs out of the box on SQLite as a single-user instance, but it’s designed to scale up:

  • PostgreSQL backend instead of SQLite, for multi-user / team setups
  • Multiplayer mode with worktree-level RBAC and per-user permissions
  • Unix-user impersonation so each Agor user’s sessions run as their own OS identity
  • Docker Compose and source builds
  • Custom config / database paths for non-default install layouts

For any of those, see Extended Installation. For credential alternatives (Claude Max/Pro plan, server-side claude login, workspace-wide env vars), see Authentication.

What’s next

Get help

OverviewExtended Installation
BSL 1.1 © 2026 Maxime Beauchemin