@appoly/multiagent-chat 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# Multi-Agent Chat
+
+An Electron app that enables multiple AI agents (Claude, Codex, etc.) to collaborate on challenges through a shared chat interface.
+
+Uses your local installations of AI agents via command line. Bring your own API keys and configurations.
+
+## Installation
+
+### Global Install (Recommended)
+
+```bash
+npm i -g multiagent-chat
+```
+
+### From Source
+
+```bash
+git clone <repo>
+cd multiagent-chat
+npm install
+npm start
+```
+
+## Usage
+
+```bash
+# Run in current directory (uses cwd as workspace)
+multiagent-chat
+
+# Specify workspace explicitly
+multiagent-chat /path/to/project
+multiagent-chat --workspace /path/to/project
+
+# With custom config file
+multiagent-chat --config /path/to/config.yaml
+
+# Environment variables also work
+WORKSPACE=/path/to/project multiagent-chat
+```
+
+## Configuration
+
+On first run, a default config is created at `~/.multiagent-chat/config.yaml`.
+
+```yaml
+agents:
+  - name: "Claude"
+    command: "claude"
+    args: ['--dangerously-skip-permissions']
+    use_pty: true
+
+  - name: "Codex"
+    command: "codex"
+    args: []
+    use_pty: true
+```
+
+You can override with a project-local config using `--config /path/to/config.yaml`.
+
+### Config Location
+
+- **Global config**: `~/.multiagent-chat/config.yaml`
+- **Recent workspaces**: `~/.multiagent-chat/recent-workspaces.json`
+
+## How It Works
+
+1. Select a workspace (project directory) or use current directory
+2. Enter a challenge/topic for agents to discuss
+3. Agents communicate via outbox files (messages delivered to their PTY)
+4. Watch live collaboration in the chat panel
+5. Final agreed plan written to `PLAN_FINAL.md` in the workspace
+6. Optionally execute the plan -- other agents will review the implementation
+
+## License
+
+MIT

package/bin/multiagent-chat.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+const path = require('path');
+const { spawn } = require('child_process');
+
+// Get the electron executable path from the installed dependency
+const electron = require('electron');
+
+// Launch electron with our main.js, passing through all CLI args
+const child = spawn(electron, [path.join(__dirname, '..'), ...process.argv.slice(2)], {
+  stdio: 'inherit',
+  windowsHide: false
+});
+
+child.on('close', (code) => process.exit(code));

package/config.yaml

@@ -0,0 +1,158 @@
+# Default configuration - copied to ~/.multiagent-chat/config.yaml on first run
+# Edit your local copy at ~/.multiagent-chat/config.yaml, not this file
+#
+# Multi-Agent Chat Configuration
+# Define the agents that will collaborate on challenges
+
+# Agent colors - used in the chat UI
+# Default colors cycle through this palette if not specified per-agent
+default_agent_colors:
+  - "#14f195"  # Mint/Teal
+  - "#22d3ee"  # Cyan
+  - "#3b82f6"  # Blue
+  - "#22c55e"  # Green
+  - "#f59e0b"  # Amber
+  - "#ff453a"  # Red
+
+# User message styling
+user_color: "#94a3b8"  # Slate for user messages
+
+agents:
+  - name: "Claude"
+    command: "claude"
+    args: ['--dangerously-skip-permissions']
+    use_pty: true
+    color: "#3b82f6"  # Blue for Claude
+
+  - name: "Codex"
+    command: "codex"
+    args: []
+    use_pty: true
+    color: "#22c55e"  # Green for Codex
+
+#  - name: "Gemini"
+#    # If the command below doesn't work, use `which gemini` to find the path on your system.
+#    command: "gemini"
+#    use_pty: true
+#    color: "#f59e0b"  # Amber for Gemini
+#    init_delay_ms: 1500
+#    args: ['--yolo']
+
+# Example: Multiple instances of the same agent type
+# Useful for having the same model debate from different perspectives
+#  - name: "Claude-Alpha"
+#    command: "claude"
+#    args: ['--dangerously-skip-permissions']
+#    use_pty: true
+#    color: "#3b82f6"  # Blue
+#
+#  - name: "Claude-Beta"
+#    command: "claude"
+#    args: ['--dangerously-skip-permissions']
+#    use_pty: true
+#    color: "#8b5cf6"  # Purple
+
+# Working directory for chat files (hidden to avoid cluttering projects)
+workspace: "./.multiagent-chat"
+
+# Chat file (JSONL format for structured UI rendering)
+chat_file: "chat.jsonl"
+
+# Outbox directory (agents write here to send messages)
+outbox_dir: "outbox"
+
+# Final plan file name
+plan_file: "PLAN_FINAL.md"
+
+# Prompts section
+prompts:
+  # Sent when user clicks "Start Implementing" and selects an agent
+  # Placeholders: {selected_agent}, {other_agents}
+  implementation_handoff: |
+    ## 🚀 IMPLEMENTATION STAGE BEGINS
+
+    The planning phase is complete. You are now entering the **IMPLEMENTATION** stage.
+
+    **{selected_agent}**: You are the lead implementer. Please implement the agreed plan now. You may create, modify, and delete files as needed.
+
+    **{other_agents}**: Wait for {selected_agent} to confirm they have completed the implementation. Then review the changes and provide feedback. Iterate together until everyone is satisfied with the result.
+
+# Prompt template for agents
+# This is sent via PTY when the session starts
+prompt_template: |
+  ## Multi-Agent Collaboration Session
+
+  **You are: {agent_name}**
+
+  You are collaborating with: {agent_names}
+
+  ### How This Works
+
+  1. **Messages from other agents will appear in your terminal** - the chat system delivers them to you
+  2. **To send a message**, write to `{outbox_file}` using a shell command (see below)
+  3. **Stay active** - keep responding to messages until you reach consensus
+  4. **When done**, one agent should write the final agreed solution to `{plan_file}`
+
+  You do NOT need to read any chat files - messages come to you automatically.
+
+  ### IMPORTANT: How to Send Messages
+
+  Use a shell command to write to your outbox - this is MUCH faster than using file editing tools:
+
+  ```bash
+  cat << 'EOF' > {outbox_file}
+  Your message here.
+  Can be multiple lines.
+  EOF
+  ```
+
+  Do NOT use built-in file read/write tools - they are slower. Just use `cat` with a heredoc.
+
+  ### Guidelines
+
+  - **Sign your messages** - Start or end with your name (e.g., "— {agent_name}") so others know who's speaking
+  - Challenge each other's ideas constructively
+  - Don't be too agreeable - push for the best solution
+  - Wait for responses before sending multiple messages. DO NOT send multiple in a row without good reason
+  - Only implement things if the user explicitly asks
+  - Explore for yourself rather than relying on the findings of others
+
+  ### Finalising: Explicit Agreement Required
+
+  Before writing to `{plan_file}`, you MUST have **explicit agreement from ALL agents**.
+
+  - "No objections" or silence is NOT agreement
+  - Each agent must explicitly say they agree with the final solution
+  - Use clear language like "I agree with this final version" or "Confirmed, let's go with this"
+  - Only after ALL agents have explicitly confirmed should one agent write `{plan_file}`
+
+  ### When to Stop
+
+  Once `{plan_file}` has been written and all agents have confirmed, **STOP RESPONDING**.
+
+  Why? Each message you send triggers other agents to respond, creating an endless loop.
+  When the task is done, simply stop - do not send "Done!", "Confirmed!", "Acknowledged!", etc.
+
+  ---
+
+  ## ⚠️ PLANNING STAGE ONLY - DO NOT IMPLEMENT
+
+  This session has two distinct phases:
+
+  1. **PLANNING (current phase)** - Discuss, debate, and agree on a plan. Write the agreed plan to `{plan_file}`. DO NOT write any code or make any changes to the codebase.
+
+  2. **IMPLEMENTATION (later)** - Only begins when the user explicitly says "implement" or "start implementing". Until then, your job is ONLY to plan.
+
+  **You are currently in the PLANNING phase. Do not create, modify, or delete any files except your outbox and `{plan_file}`.**
+
+  ---
+
+  ## Topic to Discuss
+
+  {challenge}
+
+  ---
+
+  **Remember: PLAN ONLY. Do not implement anything yet.**
+
+  Send your opening thoughts now using: cat << 'EOF' > {outbox_file}

package/index.html

@@ -0,0 +1,211 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <link rel="icon" type="image/png" href="robot.png">
+  <title>Multi-Agent Chat</title>
+  <link rel="stylesheet" href="node_modules/@xterm/xterm/css/xterm.css">
+  <link rel="stylesheet" href="styles.css">
+  <script src="node_modules/@xterm/xterm/lib/xterm.js"></script>
+  <script src="node_modules/@xterm/addon-fit/lib/addon-fit.js"></script>
+  <script src="node_modules/marked/lib/marked.umd.js"></script>
+</head>
+<body>
+  <!-- Challenge Input Screen -->
+  <div id="challenge-screen" class="screen active">
+    <div class="challenge-layout">
+      <!-- Workspace Picker Sidebar -->
+      <div class="workspace-sidebar">
+        <div class="workspace-sidebar-header">
+          <h3>Workspace</h3>
+        </div>
+        <div class="workspace-list-container">
+          <ul id="recent-workspaces" class="workspace-list">
+            <li class="workspace-empty">Loading...</li>
+          </ul>
+        </div>
+        <div class="workspace-actions">
+          <button id="browse-workspace-button" class="workspace-action-button">
+            <span class="action-icon">📁</span>
+            Browse...
+          </button>
+          <button id="use-cwd-button" class="workspace-action-button" style="display: none;">
+            <span class="action-icon">📍</span>
+            Use Current Directory
+          </button>
+        </div>
+        <div class="workspace-footer">
+          <button id="edit-config-button" class="config-link-button">
+            Edit configuration →
+          </button>
+        </div>
+      </div>
+
+      <!-- Main Card -->
+      <div class="container">
+        <h1><img src="robot.png" alt="Robot" class="header-icon"> Multi-Agent Chat</h1>
+        <p class="subtitle">Autonomous collaboration for complex challenges</p>
+
+        <div id="selected-workspace-info" class="selected-workspace-info" style="display: none;">
+          <span class="selected-label">Selected workspace:</span>
+          <span id="selected-workspace-path" class="selected-path"></span>
+          <span id="cli-badge" class="cli-badge" style="display: none;">(via CLI)</span>
+        </div>
+
+        <div class="challenge-input-container">
+          <textarea
+            id="challenge-input"
+            placeholder="Describe your challenge... (e.g., 'Refactor the authentication logic in src/auth.ts to use JWT')"
+            rows="10"
+          ></textarea>
+        </div>
+
+        <button id="start-button" class="primary-button" disabled>Select a Workspace</button>
+
+        <div id="config-info" class="config-info">
+          <h3>Current Environment</h3>
+          <div id="config-details">Loading...</div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Main Session Screen -->
+  <div id="session-screen" class="screen">
+    <div class="header">
+      <h2><img src="robot.png" alt="Robot" class="header-icon"> Chat <span class="divider">/</span> <span class="subtext">Session</span></h2>
+      <div class="header-info">
+        <div id="workspace-path">Loading...</div>
+        <button id="new-session-button" class="secondary-button" title="New Session (⌘⇧N)">New Session</button>
+      </div>
+    </div>
+
+    <div class="main-content">
+      <!-- Left Panel: Agent Outputs -->
+      <div class="left-panel">
+        <div class="panel-header">
+          <h3>Terminal Instances</h3>
+        </div>
+        <div id="agent-tabs" class="tabs"></div>
+        <div id="agent-outputs" class="agent-outputs"></div>
+      </div>
+
+      <!-- Horizontal Resize Handle -->
+      <div class="resize-handle resize-handle-h" data-resize="main"></div>
+
+      <!-- Right Panel: Chat, Plan, and Diff -->
+      <div class="right-panel">
+        <!-- Top-Level Main Tabs -->
+        <div class="main-tabs">
+          <button id="main-tab-chat" class="main-tab active" data-tab="chat">Chat</button>
+          <button id="main-tab-plan" class="main-tab" data-tab="plan">Plan</button>
+          <button id="main-tab-diff" class="main-tab" data-tab="diff">
+            Diff
+            <span id="diff-badge" class="diff-badge" style="display: none;"></span>
+          </button>
+        </div>
+
+        <!-- Chat Tab Content -->
+        <div id="chat-tab-content" class="tab-content active">
+          <div class="chat-section">
+            <div class="panel-header">
+              <h3>Communication Stream</h3>
+            </div>
+            <div id="chat-viewer" class="chat-viewer"></div>
+            <div id="chat-new-messages" class="chat-new-messages" aria-hidden="true">
+              <button id="chat-new-messages-button" class="small-button">New messages ↓</button>
+            </div>
+          </div>
+          <div class="message-section">
+            <div class="panel-header">
+              <h3>Direct Intervention</h3>
+            </div>
+            <div class="message-input-container">
+              <textarea
+                id="user-message-input"
+                placeholder="Send instruction to all agents..."
+                rows="2"
+              ></textarea>
+              <button id="send-message-button" class="primary-button">Send</button>
+            </div>
+          </div>
+        </div>
+
+        <!-- Plan Tab Content -->
+        <div id="plan-tab-content" class="tab-content">
+          <div class="plan-section">
+            <div class="panel-header">
+              <h3>Final Plan</h3>
+              <div class="panel-header-actions">
+                <button id="refresh-plan-button" class="small-button">Refresh</button>
+              </div>
+            </div>
+            <div id="plan-viewer" class="plan-viewer">
+              <em>Awaiting agent synthesis...</em>
+            </div>
+            <div class="plan-actions">
+              <button id="start-implementing-button" class="primary-button large" style="display: none;">Start Implementing</button>
+            </div>
+          </div>
+        </div>
+
+        <!-- Diff Tab Content -->
+        <div id="diff-tab-content" class="tab-content">
+          <div class="diff-section">
+            <div class="panel-header">
+              <h3>Git Changes</h3>
+              <div class="panel-header-actions">
+                <div id="diff-stats" class="diff-stats"></div>
+                <button id="refresh-diff-button" class="small-button">Refresh</button>
+              </div>
+            </div>
+            <div class="diff-layout">
+              <!-- File List Pane -->
+              <div class="diff-file-list">
+                <div class="file-list-header">Changed Files</div>
+                <ul id="diff-file-list-items" class="file-list-items"></ul>
+              </div>
+              <!-- Resize Handle for Diff Panes -->
+              <div class="resize-handle resize-handle-h diff-resize" data-resize="diff"></div>
+              <!-- Diff Content Pane -->
+              <div class="diff-content-pane">
+                <div id="diff-content" class="diff-content">
+                  <em>Select a file or view all changes...</em>
+                </div>
+              </div>
+            </div>
+            <div id="diff-untracked" class="diff-untracked"></div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Implementation Modal -->
+  <div id="implementation-modal" class="modal" style="display: none;">
+    <div class="modal-content">
+      <h3>Who should implement the plan?</h3>
+      <div id="agent-selection" class="agent-selection"></div>
+      <div class="modal-actions">
+        <button id="modal-cancel" class="small-button">Cancel</button>
+        <button id="modal-start" class="small-button primary">Start</button>
+      </div>
+    </div>
+  </div>
+
+  <!-- New Session Modal -->
+  <div id="new-session-modal" class="modal" style="display: none;">
+    <div class="modal-content">
+      <h3>Start New Session?</h3>
+      <p class="modal-description">Chat history and plan will be cleared. This won't undo code changes.</p>
+      <div class="modal-actions">
+        <button id="new-session-cancel" class="small-button">Cancel</button>
+        <button id="new-session-confirm" class="small-button primary">Start New Session</button>
+      </div>
+    </div>
+  </div>
+
+  <script src="renderer.js"></script>
+</body>
+</html>