agor-live 0.3.7 → 0.3.10

package/README.md

@@ -1,163 +1,43 @@
-<img src="https://github.com/user-attachments/assets/e34f3d25-71dd-4084-8f3e-4f1c73381c66" alt="Agor Logo" width="320" />
+# agor-live
 
-# Agor
+**Multiplayer canvas for orchestrating AI coding sessions**
 
-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.
+Agor is a real-time collaborative platform for managing Claude Code, Codex, and Gemini AI coding sessions. Visualize work on spatial boards, track git worktrees, and collaborate with your team.
 
-**[Docs](https://mistercrunch.github.io/agor/)** | **[Discussions](https://github.com/mistercrunch/agor/discussions)**
-
----
-
-## Quick Start
-
-**Install globally (recommended):**
+## Installation
 
 ```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):
+## Quick Start
 
 ```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
+# Start the daemon
+agor daemon start
 
----
+# Initialize / configure
+agor daemon init
 
-## Architecture
+# Open UI in browser
+agor ui open
 
 ```
-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.
+## Features
 
-### 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
-```
+- **Multi-Agent Support**: Claude Code, OpenAI Codex, Google Gemini
+- **Git Integration**: Worktree-based workflows with branch management
+- **Spatial Boards**: Visual canvas for organizing sessions and tasks
+- **Real-time Collaboration**: WebSocket-powered multiplayer features
+- **Task Tracking**: First-class task primitives with genealogy
+- **MCP Integration**: Model Context Protocol server management
 
-See [CLAUDE.md](CLAUDE.md) for dev workflow and [PROJECT.md](PROJECT.md) for roadmap.
+## Documentation
 
----
+- **GitHub**: https://github.com/agorapp/agor
+- **Docs**: https://agor.live
 
-## Roadmap
+## License
 
-- 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)
+BSL-1.1

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

@@ -1,17 +1,17 @@
 // src/commands/config/get.ts
-import { getConfigValue, getContext } from "@agor/core/config";
+import { getConfigValue } 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 %> defaults.board",
+    "<%= config.bin %> <%= command.id %> defaults.agent",
     "<%= 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)",
+      description: "Configuration key in format: section.key (e.g., daemon.port, credentials.ANTHROPIC_API_KEY)",
       required: true
     })
   };
@@ -19,13 +19,7 @@ var ConfigGet = class _ConfigGet extends Command {
     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);
-      }
+      const value = await getConfigValue(key);
       if (value !== void 0) {
         this.log(String(value));
       } else {

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

@@ -1,7 +1,7 @@
 import { Command } from '@oclif/core';
 
 /**
- * `agor config` - Show all configuration and active context
+ * `agor config` - Show all configuration
  */
 
 declare class ConfigIndex extends Command {

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

@@ -1,32 +1,16 @@
 // src/commands/config/index.ts
-import { getConfigPath, getEffectiveConfig, loadConfig } from "@agor/core/config";
+import { getConfigPath, getDefaultConfig, loadConfig } from "@agor/core/config";
 import { Command } from "@oclif/core";
 import chalk from "chalk";
 var ConfigIndex = class extends Command {
-  static description = "Show current configuration and active context";
+  static description = "Show current configuration";
   static examples = ["<%= config.bin %> <%= command.id %>"];
   async run() {
     try {
       const config = await loadConfig();
-      const effective = await getEffectiveConfig(config);
+      const defaults = getDefaultConfig();
       this.log(chalk.bold("\nCurrent Configuration"));
       this.log(chalk.dim("\u2500".repeat(50)));
-      this.log(chalk.bold("\nActive Context:"));
-      if (effective.board) {
-        this.log(`  board:   ${chalk.cyan(effective.board)}`);
-      }
-      if (effective.session) {
-        this.log(`  session: ${chalk.cyan(effective.session)}`);
-      }
-      if (effective.repo) {
-        this.log(`  repo:    ${chalk.cyan(effective.repo)}`);
-      }
-      if (effective.agent) {
-        this.log(`  agent:   ${chalk.cyan(effective.agent)}`);
-      }
-      if (!effective.board && !effective.session && !effective.repo && !effective.agent) {
-        this.log(chalk.dim("  (no active context)"));
-      }
       this.log(chalk.bold("\nGlobal Defaults:"));
       if (config.defaults?.board) {
         this.log(`  default board: ${chalk.gray(config.defaults.board)}`);
@@ -54,8 +38,6 @@ var ConfigIndex = class extends Command {
           }
         }
       }
-      const { getDefaultConfig } = await import("@agor/core/config");
-      const defaults = getDefaultConfig();
       const daemonConfig = { ...defaults.daemon, ...config.daemon };
       if (daemonConfig) {
         this.log(chalk.bold("\nDaemon Settings:"));
@@ -86,9 +68,6 @@ var ConfigIndex = class extends Command {
       this.log(chalk.bold("\nAvailable Configuration Keys:"));
       this.log(chalk.dim("  Use `agor config set <key> <value>` to set any of these:"));
       this.log("");
-      this.log(chalk.cyan("  Context (temporary, cleared with `agor config clear`):"));
-      this.log("    board, session, repo, agent");
-      this.log("");
       this.log(chalk.cyan("  Defaults:"));
       this.log("    defaults.board, defaults.agent");
       this.log("");
@@ -99,7 +78,7 @@ var ConfigIndex = class extends Command {
       this.log("    credentials.ANTHROPIC_API_KEY");
       this.log("    credentials.OPENAI_API_KEY");
       this.log("    credentials.CURSOR_API_KEY");
-      this.log("    credentials.GOOGLE_API_KEY");
+      this.log("    credentials.GEMINI_API_KEY");
       this.log("");
       this.log(chalk.cyan("  Daemon:"));
       this.log("    daemon.port, daemon.host");

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

@@ -5,16 +5,14 @@ import chalk from "chalk";
 var ConfigSet = class _ConfigSet extends Command {
   static description = "Set a configuration value";
   static examples = [
-    "<%= config.bin %> <%= command.id %> board experiments",
-    "<%= config.bin %> <%= command.id %> session 01933e4a",
-    "<%= config.bin %> <%= command.id %> repo anthropics/agor:main",
-    "<%= config.bin %> <%= command.id %> agent claude-code",
+    "<%= config.bin %> <%= command.id %> defaults.board experiments",
+    "<%= config.bin %> <%= command.id %> defaults.agent claude-code",
     "<%= config.bin %> <%= command.id %> credentials.ANTHROPIC_API_KEY sk-ant-...",
-    "<%= config.bin %> <%= command.id %> defaults.agent cursor"
+    "<%= config.bin %> <%= command.id %> daemon.port 4000"
   ];
   static args = {
     key: Args.string({
-      description: "Configuration key (supports dot notation: credentials.ANTHROPIC_API_KEY)",
+      description: "Configuration key in format: section.key (e.g., daemon.port, credentials.ANTHROPIC_API_KEY)",
       required: true
     }),
     value: Args.string({

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

@@ -1,27 +1,25 @@
 // src/commands/config/unset.ts
-import { unsetContext } from "@agor/core/config";
+import { unsetConfigValue } from "@agor/core/config";
 import { Args, Command } from "@oclif/core";
 import chalk from "chalk";
 var ConfigUnset = class _ConfigUnset extends Command {
   static description = "Unset (clear) a configuration value";
   static examples = [
-    "<%= config.bin %> <%= command.id %> board",
-    "<%= config.bin %> <%= command.id %> session",
-    "<%= config.bin %> <%= command.id %> repo",
-    "<%= config.bin %> <%= command.id %> agent"
+    "<%= config.bin %> <%= command.id %> defaults.board",
+    "<%= config.bin %> <%= command.id %> defaults.agent",
+    "<%= config.bin %> <%= command.id %> credentials.ANTHROPIC_API_KEY"
   ];
   static args = {
     key: Args.string({
-      description: "Configuration key to unset (board, session, repo, agent)",
-      required: true,
-      options: ["board", "session", "repo", "agent"]
+      description: "Configuration key in format: section.key (e.g., defaults.board)",
+      required: true
     })
   };
   async run() {
     const { args } = await this.parse(_ConfigUnset);
     const key = args.key;
     try {
-      await unsetContext(key);
+      await unsetConfigValue(key);
       this.log(`${chalk.green("\u2713")} Unset ${chalk.cyan(key)}`);
     } catch (error) {
       this.error(

package/dist/cli/commands/session/load-claude.js

@@ -92,7 +92,6 @@ ${chalk.blue("\u25CF")} Loading Claude Code session: ${chalk.cyan(sessionId)}
         // Will be auto-assigned by service hook
         path: absoluteProjectDir,
         new_branch: false,
-        sessions: [],
         last_used: (/* @__PURE__ */ new Date()).toISOString(),
         created_at: (/* @__PURE__ */ new Date()).toISOString(),
         updated_at: (/* @__PURE__ */ new Date()).toISOString(),

package/dist/cli/commands/{repo/worktree → worktree}/add.d.ts

@@ -5,10 +5,10 @@ declare class WorktreeAdd extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        repoSlug: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
         name: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        'repo-id': _oclif_core_interfaces.OptionFlag<string, _oclif_core_interfaces.CustomOptions>;
         branch: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;
         checkout: _oclif_core_interfaces.BooleanFlag<boolean>;
         ref: _oclif_core_interfaces.OptionFlag<string | undefined, _oclif_core_interfaces.CustomOptions>;

package/dist/cli/commands/{repo/worktree → worktree}/add.js

@@ -1,4 +1,4 @@
-// src/commands/repo/worktree/add.ts
+// src/commands/worktree/add.ts
 import { createClient, isDaemonRunning } from "@agor/core/api";
 import { getDaemonUrl } from "@agor/core/config";
 import { Args, Command, Flags } from "@oclif/core";
@@ -7,27 +7,27 @@ var WorktreeAdd = class _WorktreeAdd extends Command {
   static description = "Create a git worktree for isolated development";
   static examples = [
     // Case 1: Create new branch (worktree name = branch name)
-    "<%= config.bin %> <%= command.id %> superset feature-auth",
+    "<%= config.bin %> <%= command.id %> feature-auth --repo-id 01933e4a",
     // Case 2: Create new branch with different name
-    "<%= config.bin %> <%= command.id %> superset my-experiment --branch feature-x",
+    "<%= config.bin %> <%= command.id %> my-experiment --repo-id 01933e4a --branch feature-x",
     // Case 3: Checkout existing branch
-    "<%= config.bin %> <%= command.id %> superset fix-api --checkout",
+    "<%= config.bin %> <%= command.id %> fix-api --repo-id 01933e4a --checkout",
     // Case 4: Checkout specific ref
-    "<%= config.bin %> <%= command.id %> superset debug-session --ref abc123def",
+    "<%= config.bin %> <%= command.id %> debug-session --repo-id 01933e4a --ref abc123def",
     // Case 5: Create branch from specific base
-    "<%= config.bin %> <%= command.id %> superset feature-y --from develop"
+    "<%= config.bin %> <%= command.id %> feature-y --repo-id 01933e4a --from develop"
   ];
   static args = {
-    repoSlug: Args.string({
-      description: "Repository slug",
-      required: true
-    }),
     name: Args.string({
       description: "Worktree name (becomes branch name if creating new)",
       required: true
     })
   };
   static flags = {
+    "repo-id": Flags.string({
+      description: "Repository ID",
+      required: true
+    }),
     branch: Flags.string({
       char: "b",
       description: "Branch name (defaults to same as worktree name)"
@@ -62,16 +62,7 @@ var WorktreeAdd = class _WorktreeAdd extends Command {
     try {
       const client = createClient(daemonUrl);
       const reposService = client.service("repos");
-      const repos = await reposService.find({
-        query: { slug: args.repoSlug, $limit: 1 }
-      });
-      const reposList = Array.isArray(repos) ? repos : repos.data;
-      if (!reposList || reposList.length === 0) {
-        this.error(
-          `Repository '${args.repoSlug}' not found. Use ${chalk.cyan("agor repo list")} to see available repos.`
-        );
-      }
-      const repo = reposList[0];
+      const repo = await reposService.get(flags["repo-id"]);
       const worktreesService = client.service("worktrees");
       const existingWorktrees = await worktreesService.find({
         query: {
@@ -86,7 +77,7 @@ var WorktreeAdd = class _WorktreeAdd extends Command {
       this.log("");
       this.log(
         chalk.bold(
-          `Creating worktree ${chalk.cyan(args.name)} in repository ${chalk.cyan(args.repoSlug)}...`
+          `Creating worktree ${chalk.cyan(args.name)} in repository ${chalk.cyan(flags["repo-id"])}...`
         )
       );
       this.log("");
@@ -128,7 +119,7 @@ var WorktreeAdd = class _WorktreeAdd extends Command {
       this.log(chalk.bold("Next steps:"));
       this.log(`  ${chalk.dim("cd")} ${newWorktree.path}`);
       this.log(
-        `  ${chalk.dim("or start session:")} ${chalk.cyan(`agor session start --repo ${args.repoSlug} --worktree ${args.name}`)}`
+        `  ${chalk.dim("or start session:")} ${chalk.cyan(`agor session start --repo ${flags["repo-id"]} --worktree ${args.name}`)}`
       );
       this.log("");
       client.io.close();

package/dist/cli/commands/worktree/env/restart.d.ts

@@ -0,0 +1,15 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { BaseCommand } from '../../../base-command.js';
+import '@agor/core/api';
+import '@oclif/core';
+
+declare class WorktreeEnvRestart extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        worktreeId: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+
+export { WorktreeEnvRestart as default };

package/dist/cli/commands/worktree/env/restart.js

@@ -0,0 +1,90 @@
+// src/commands/worktree/env/restart.ts
+import { formatShortId } from "@agor/core/db";
+import { Args } from "@oclif/core";
+import chalk2 from "chalk";
+
+// 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);
+    });
+  }
+};
+
+// src/commands/worktree/env/restart.ts
+var WorktreeEnvRestart = class _WorktreeEnvRestart extends BaseCommand {
+  static description = "Restart worktree environment";
+  static examples = [
+    "<%= config.bin %> <%= command.id %> abc123",
+    "<%= config.bin %> <%= command.id %> 01933e4a-b2c1-7890-a456-789012345678"
+  ];
+  static args = {
+    worktreeId: Args.string({
+      description: "Worktree ID (full UUID or short ID)",
+      required: true
+    })
+  };
+  async run() {
+    const { args } = await this.parse(_WorktreeEnvRestart);
+    const client = await this.connectToDaemon();
+    try {
+      const worktreesService = client.service("worktrees");
+      const worktree = await worktreesService.get(args.worktreeId);
+      this.log("");
+      this.log(`Restarting environment for ${chalk2.cyan(worktree.name)}...`);
+      this.log(`  ID:   ${chalk2.dim(formatShortId(worktree.worktree_id))}`);
+      this.log("");
+      const updated = await worktreesService.restartEnvironment(worktree.worktree_id);
+      this.log(`${chalk2.green("\u2713")} Environment restarted`);
+      if (updated.environment_instance?.access_urls) {
+        this.log("");
+        this.log(chalk2.bold("Access URLs:"));
+        for (const url of updated.environment_instance.access_urls) {
+          this.log(`  ${url.name}: ${chalk2.blue(url.url)}`);
+        }
+      }
+      this.log("");
+      await this.cleanupClient(client);
+      process.exit(0);
+    } catch (error) {
+      await this.cleanupClient(client);
+      this.error(
+        `Failed to restart environment: ${error instanceof Error ? error.message : String(error)}`
+      );
+    }
+  }
+};
+export {
+  WorktreeEnvRestart as default
+};

package/dist/cli/commands/worktree/env/start.d.ts

@@ -0,0 +1,15 @@
+import * as _oclif_core_interfaces from '@oclif/core/interfaces';
+import { BaseCommand } from '../../../base-command.js';
+import '@agor/core/api';
+import '@oclif/core';
+
+declare class WorktreeEnvStart extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        worktreeId: _oclif_core_interfaces.Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}
+
+export { WorktreeEnvStart as default };