agor-live 0.3.7

package/LICENSE

@@ -0,0 +1,94 @@
+Business Source License 1.1
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+---
+
+Parameters
+
+Licensor:             Maxime Beauchemin
+Licensed Work:        Agor
+                      The Licensed Work is (c) 2025 Maxime Beauchemin
+Additional Use Grant: None
+Change Date:          2029-01-15
+Change License:       Apache License, Version 2.0
+
+---
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license
+your works, and to refer to it using the trademark "Business Source License",
+as long as you comply with the Covenants of Licensor below.
+
+---
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.
+
+---
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.

package/README.md

@@ -0,0 +1,163 @@
+<img src="https://github.com/user-attachments/assets/e34f3d25-71dd-4084-8f3e-4f1c73381c66" alt="Agor Logo" width="320" />
+
+# 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.
+
+**[Docs](https://mistercrunch.github.io/agor/)** | **[Discussions](https://github.com/mistercrunch/agor/discussions)**
+
+---
+
+## Quick Start
+
+**Install globally (recommended):**
+
+```bash
+npm install -g agor-live
+agor daemon start
+agor ui open
+```
+
+**Or try in Codespaces** (for team collaboration with public URL):
+
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/mistercrunch/agor?quickstart=1&devcontainer_path=.devcontainer%2Fplayground%2Fdevcontainer.json)
+
+**Or run with Docker** (for contributing):
+
+```bash
+docker compose up
+# Open http://localhost:5173
+# Login: admin@agor.live / admin
+```
+
+---
+
+## Screenshots
+
+![Agor Hero](apps/agor-docs/public/hero.png)
+
+_Multiplayer spatial canvas with zones, real-time cursors, and session organization_
+
+<div align="center">
+<table>
+<tr>
+<td width="50%">
+
+![Conversation View](apps/agor-docs/public/screenshots/conversation_full_page.png)
+
+<p align="center"><em>Task-centric conversation UI</em></p>
+
+</td>
+<td width="50%">
+
+![Settings Modal](apps/agor-docs/public/screenshots/settings_modal.png)
+
+<p align="center"><em>MCP server and worktree management</em></p>
+
+</td>
+</tr>
+<tr>
+<td width="50%">
+
+![Create Session Modal](apps/agor-docs/public/screenshots/create_session_modal.png)
+
+<p align="center"><em>Session creation with agent selection</em></p>
+
+</td>
+<td width="50%">
+
+![Zone Trigger Modal](apps/agor-docs/public/screenshots/zone_trigger_modal.png)
+
+<p align="center"><em>Zone trigger configuration</em></p>
+
+</td>
+</tr>
+</table>
+</div>
+
+---
+
+## What It Does
+
+- **Agent orchestration** - Run Claude Code, Codex, Gemini from one interface
+- **Git worktree management** - Isolated workspaces per session, no branch conflicts
+- **Real-time board** - Drag sessions around, organize by project/phase/zone
+- **Session tracking** - Every AI conversation is stored, searchable, forkable
+- **MCP integration** - Configure MCP servers once, use across all agents
+- **Multiplayer** - See teammates' sessions, share environments, async handoffs
+
+---
+
+## Core Concepts
+
+**Sessions** - Container for agent interactions with git state, tasks, genealogy
+**Worktrees** - Git worktrees managed by Agor, isolated per session
+**Boards** - Spatial canvas for organizing sessions (like Trello for AI work)
+**Zones** - Areas on board that trigger templated prompts when sessions dropped
+**Tasks** - User prompts tracked as first-class work units
+
+---
+
+## Architecture
+
+```
+Frontend (React + Ant Design)
+    ↓ WebSocket
+Daemon (FeathersJS)
+    ↓
+Database (LibSQL) + Git Worktrees
+    ↓
+Agent SDKs (Claude, Codex, Gemini)
+```
+
+**Stack:** FeathersJS, Drizzle ORM, LibSQL, React Flow, Ant Design
+
+See [Architecture Guide](https://mistercrunch.github.io/agor/guide/architecture) for details.
+
+---
+
+## Key Features
+
+### Git Worktree Management
+
+Every session maps to a git worktree - no more branch conflicts when running parallel AI work.
+
+### Environment Management
+
+Start/stop dev servers per worktree. Each gets unique ports. Share running environments with teammates via URL.
+
+### Zone Triggers
+
+Drop sessions on zones to trigger templated workflows (analyze → develop → review → deploy).
+
+### Session Genealogy
+
+Fork sessions to explore alternatives. Spawn subsessions with fresh context. Full ancestry tracking.
+
+### Multi-Agent Support
+
+Swap between Claude/Codex/Gemini mid-task. Compare outputs. Hand off when one model stalls.
+
+---
+
+## Development
+
+```bash
+# Terminal 1: Daemon
+cd apps/agor-daemon && pnpm dev  # :3030
+
+# Terminal 2: UI
+cd apps/agor-ui && pnpm dev      # :5173
+```
+
+See [CLAUDE.md](CLAUDE.md) for dev workflow and [PROJECT.md](PROJECT.md) for roadmap.
+
+---
+
+## Roadmap
+
+- Match CLI-native features as SDKs evolve
+- Bring Your Own IDE (VSCode/Cursor remote connection)
+- Session forking UI with genealogy visualization
+- Automated reports after task completion
+- Context management system (modular markdown files)

package/bin/agor-daemon.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+
+/**
+ * Agor Daemon Entry Point (Production)
+ *
+ * This entry point loads the bundled daemon from dist/daemon.
+ * The daemon is compiled from apps/agor-daemon and bundled during build.
+ */
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// Get directory of this file
+const dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Daemon is bundled in dist/daemon relative to bin/
+const daemonPath = path.resolve(dirname, '../dist/daemon/index.js');
+
+// Import and run the daemon
+await import(daemonPath);

package/bin/agor.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+/**
+ * Agor CLI Entry Point (Production)
+ *
+ * This entry point loads the bundled CLI from dist/cli.
+ * The CLI commands are compiled from apps/agor-cli and bundled during build.
+ */
+
+import { execute } from '@oclif/core';
+
+// oclif will resolve commands relative to this file
+// Commands are at ../dist/cli/commands (configured in package.json)
+await execute({ development: false, dir: import.meta.url });

package/dist/cli/base-command.d.ts

@@ -0,0 +1,29 @@
+import { AgorClient } from '@agor/core/api';
+import { Command } from '@oclif/core';
+
+/**
+ * Base Command - Shared logic for all Agor CLI commands
+ *
+ * Reduces boilerplate by providing common functionality like daemon connection checking.
+ */
+
+/**
+ * Base command with daemon connection utilities
+ */
+declare abstract class BaseCommand extends Command {
+    protected daemonUrl: string | null;
+    /**
+     * Connect to daemon (checks if running first)
+     *
+     * @returns Feathers client instance
+     */
+    protected connectToDaemon(): Promise<AgorClient>;
+    /**
+     * Cleanup client connection
+     *
+     * Ensures socket is properly closed to prevent hanging processes
+     */
+    protected cleanupClient(client: AgorClient): Promise<void>;
+}
+
+export { BaseCommand };

package/dist/cli/base-command.js

@@ -0,0 +1,41 @@
+// src/base-command.ts
+import { createClient, isDaemonRunning } from "@agor/core/api";
+import { getDaemonUrl } from "@agor/core/config";
+import { Command } from "@oclif/core";
+import chalk from "chalk";
+var BaseCommand = class extends Command {
+  daemonUrl = null;
+  /**
+   * Connect to daemon (checks if running first)
+   *
+   * @returns Feathers client instance
+   */
+  async connectToDaemon() {
+    this.daemonUrl = await getDaemonUrl();
+    const running = await isDaemonRunning(this.daemonUrl);
+    if (!running) {
+      this.log(
+        chalk.red("\u2717 Daemon not running") + "\n\n" + chalk.bold("To start the daemon:") + "\n  " + chalk.cyan("cd apps/agor-daemon && pnpm dev") + "\n\n" + chalk.bold("To configure daemon URL:") + "\n  " + chalk.cyan("agor config set daemon.url <url>") + "\n  " + chalk.gray(`Current: ${this.daemonUrl}`)
+      );
+      this.exit(1);
+    }
+    return createClient(this.daemonUrl, true, { verbose: false });
+  }
+  /**
+   * Cleanup client connection
+   *
+   * Ensures socket is properly closed to prevent hanging processes
+   */
+  async cleanupClient(client) {
+    await new Promise((resolve) => {
+      client.io.once("disconnect", () => resolve());
+      client.io.removeAllListeners("connect");
+      client.io.removeAllListeners("connect_error");
+      client.io.close();
+      setTimeout(resolve, 1e3);
+    });
+  }
+};
+export {
+  BaseCommand
+};

package/dist/cli/commands/board/add-session.d.ts

@@ -0,0 +1,15 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { Command } from '@oclif/core';
+
+declare class BoardAddSession extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        boardId: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
+        sessionId: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    private cleanup;
+}
+
+export { BoardAddSession as default };

package/dist/cli/commands/board/add-session.js

@@ -0,0 +1,102 @@
+// src/commands/board/add-session.ts
+import { createClient } from "@agor/core/api";
+import { Args, Command } from "@oclif/core";
+import chalk from "chalk";
+var BoardAddSession = class _BoardAddSession extends Command {
+  static description = "Add a session's worktree to a board (sessions are organized through worktrees)";
+  static examples = [
+    "<%= config.bin %> <%= command.id %> default 0199b86c",
+    "<%= config.bin %> <%= command.id %> 0199b850 0199b86c-10ab-7409-b053-38b62327e695"
+  ];
+  static args = {
+    boardId: Args.string({
+      description: "Board ID or slug",
+      required: true
+    }),
+    sessionId: Args.string({
+      description: "Session ID (short or full)",
+      required: true
+    })
+  };
+  async run() {
+    const { args } = await this.parse(_BoardAddSession);
+    const client = createClient();
+    try {
+      const boardsResult = await client.service("boards").find();
+      const boards = Array.isArray(boardsResult) ? boardsResult : boardsResult.data;
+      const board = boards.find(
+        (b) => b.board_id === args.boardId || b.board_id.startsWith(args.boardId) || b.slug === args.boardId
+      );
+      if (!board) {
+        this.log(chalk.red(`\u2717 Board not found: ${args.boardId}`));
+        await this.cleanup(client);
+        process.exit(1);
+      }
+      const sessionsResult = await client.service("sessions").find();
+      const sessions = Array.isArray(sessionsResult) ? sessionsResult : sessionsResult.data;
+      const session = sessions.find(
+        (s) => s.session_id === args.sessionId || s.session_id.startsWith(args.sessionId)
+      );
+      if (!session) {
+        this.log(chalk.red(`\u2717 Session not found: ${args.sessionId}`));
+        await this.cleanup(client);
+        process.exit(1);
+      }
+      if (!session.worktree_id) {
+        this.log(chalk.red(`\u2717 Session has no worktree associated`));
+        await this.cleanup(client);
+        process.exit(1);
+      }
+      const worktreesResult = await client.service("worktrees").find();
+      const worktrees = Array.isArray(worktreesResult) ? worktreesResult : worktreesResult.data;
+      const worktree = worktrees.find((w) => w.worktree_id === session.worktree_id);
+      if (!worktree) {
+        this.log(chalk.red(`\u2717 Worktree not found for session`));
+        await this.cleanup(client);
+        process.exit(1);
+      }
+      const boardObjectsResult = await client.service("board-objects").find({
+        query: {
+          board_id: board.board_id
+        }
+      });
+      const boardObjects = Array.isArray(boardObjectsResult) ? boardObjectsResult : boardObjectsResult.data;
+      const existingObject = boardObjects.find(
+        (bo) => bo.worktree_id === worktree.worktree_id
+      );
+      if (existingObject) {
+        this.log(chalk.yellow(`\u26A0 Worktree "${worktree.name}" already on board "${board.name}"`));
+        await this.cleanup(client);
+        return;
+      }
+      await client.service("board-objects").create({
+        board_id: board.board_id,
+        worktree_id: worktree.worktree_id,
+        position: { x: 100, y: 100 }
+      });
+      this.log(
+        chalk.green(
+          `\u2713 Added worktree "${worktree.name}" (containing session ${session.session_id.substring(0, 8)}) to board "${board.name}"`
+        )
+      );
+    } catch (error) {
+      this.log(chalk.red("\u2717 Failed to add session to board"));
+      if (error instanceof Error) {
+        this.log(chalk.red(error.message));
+      }
+      await this.cleanup(client);
+      process.exit(1);
+    }
+    await this.cleanup(client);
+  }
+  async cleanup(client) {
+    await new Promise((resolve) => {
+      client.io.once("disconnect", () => resolve());
+      client.io.close();
+      setTimeout(() => resolve(), 1e3);
+    });
+  }
+};
+export {
+  BoardAddSession as default
+};

package/dist/cli/commands/board/list.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+
+/**
+ * List all boards
+ */
+
+declare class BoardList extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+    private cleanup;
+}
+
+export { BoardList as default };

package/dist/cli/commands/board/list.js

@@ -0,0 +1,74 @@
+// src/commands/board/list.ts
+import { createClient, isDaemonRunning } from "@agor/core/api";
+import { getDaemonUrl } from "@agor/core/config";
+import { Command } from "@oclif/core";
+import chalk from "chalk";
+import Table from "cli-table3";
+var BoardList = class extends Command {
+  static description = "List all boards";
+  static examples = ["<%= config.bin %> <%= command.id %>"];
+  async run() {
+    const daemonUrl = await getDaemonUrl();
+    const running = await isDaemonRunning(daemonUrl);
+    if (!running) {
+      this.log(
+        chalk.red("\u2717 Daemon not running") + "\n\n" + chalk.bold("To start the daemon:") + "\n  " + chalk.cyan("cd apps/agor-daemon && pnpm dev") + "\n\n" + chalk.bold("To configure daemon URL:") + "\n  " + chalk.cyan("agor config set daemon.url <url>") + "\n  " + chalk.gray(`Current: ${daemonUrl}`)
+      );
+      this.exit(1);
+    }
+    const client = createClient(daemonUrl, true, { verbose: false });
+    try {
+      const result = await client.service("boards").find();
+      const boards = Array.isArray(result) ? result : result.data;
+      if (boards.length === 0) {
+        this.log(chalk.yellow("No boards found."));
+        await this.cleanup(client);
+        return;
+      }
+      const boardObjectsResult = await client.service("board-objects").find();
+      const boardObjects = Array.isArray(boardObjectsResult) ? boardObjectsResult : boardObjectsResult.data;
+      const table = new Table({
+        head: [
+          chalk.cyan("ID"),
+          chalk.cyan("Name"),
+          chalk.cyan("Worktrees"),
+          chalk.cyan("Description"),
+          chalk.cyan("Created")
+        ],
+        colWidths: [12, 20, 12, 40, 12],
+        wordWrap: true
+      });
+      for (const board of boards) {
+        const worktreeCount = boardObjects.filter((bo) => bo.board_id === board.board_id).length;
+        table.push([
+          board.board_id.substring(0, 8),
+          `${board.icon || "\u{1F4CB}"} ${board.name}`,
+          worktreeCount.toString(),
+          board.description || "",
+          new Date(board.created_at).toLocaleDateString()
+        ]);
+      }
+      this.log(table.toString());
+      this.log(chalk.gray(`
+Total: ${boards.length} board(s)`));
+    } catch (error) {
+      this.log(chalk.red("\u2717 Failed to fetch boards"));
+      if (error instanceof Error) {
+        this.log(chalk.red(error.message));
+      }
+      await this.cleanup(client);
+      process.exit(1);
+    }
+    await this.cleanup(client);
+  }
+  async cleanup(client) {
+    await new Promise((resolve) => {
+      client.io.once("disconnect", () => resolve());
+      client.io.close();
+      setTimeout(() => resolve(), 1e3);
+    });
+  }
+};
+export {
+  BoardList as default
+};

package/dist/cli/commands/config/clear.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+
+/**
+ * `agor config clear` - Clear all active context
+ */
+
+declare class ConfigClear extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+
+export { ConfigClear as default };

package/dist/cli/commands/config/clear.js

@@ -0,0 +1,21 @@
+// src/commands/config/clear.ts
+import { clearContext } from "@agor/core/config";
+import { Command } from "@oclif/core";
+import chalk from "chalk";
+var ConfigClear = class extends Command {
+  static description = "Clear all active context";
+  static examples = ["<%= config.bin %> <%= command.id %>"];
+  async run() {
+    try {
+      await clearContext();
+      this.log(`${chalk.green("\u2713")} Cleared all active context`);
+    } catch (error) {
+      this.error(
+        `Failed to clear config: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+};
+export {
+  ConfigClear as default
+};

package/dist/cli/commands/config/get.d.ts

@@ -0,0 +1,13 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { Command } from '@oclif/core';
+
+declare class ConfigGet extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        key: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+
+export { ConfigGet as default };

package/dist/cli/commands/config/get.js

@@ -0,0 +1,41 @@
+// src/commands/config/get.ts
+import { getConfigValue, getContext } from "@agor/core/config";
+import { Args, Command } from "@oclif/core";
+var ConfigGet = class _ConfigGet extends Command {
+  static description = "Get a configuration value";
+  static examples = [
+    "<%= config.bin %> <%= command.id %> board",
+    "<%= config.bin %> <%= command.id %> session",
+    "<%= config.bin %> <%= command.id %> credentials.ANTHROPIC_API_KEY",
+    "<%= config.bin %> <%= command.id %> daemon.port"
+  ];
+  static args = {
+    key: Args.string({
+      description: "Configuration key (e.g., board, daemon.port, credentials.ANTHROPIC_API_KEY)",
+      required: true
+    })
+  };
+  async run() {
+    const { args } = await this.parse(_ConfigGet);
+    const key = args.key;
+    try {
+      let value;
+      const contextKeys = ["board", "session", "repo", "agent"];
+      if (contextKeys.includes(key)) {
+        value = await getContext(key);
+      } else {
+        value = await getConfigValue(key);
+      }
+      if (value !== void 0) {
+        this.log(String(value));
+      } else {
+        process.exit(1);
+      }
+    } catch (error) {
+      this.error(`Failed to get config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+};
+export {
+  ConfigGet as default
+};

package/dist/cli/commands/config/index.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+
+/**
+ * `agor config` - Show all configuration and active context
+ */
+
+declare class ConfigIndex extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}
+
+export { ConfigIndex as default };