From bb55fad0080fbbbf5bce2711b812c3aff68a0977 Mon Sep 17 00:00:00 2001 From: Ryder Sun Date: Thu, 17 Sep 2026 16:13:45 +0800 Subject: [PATCH] docs: reposition product as General Agent workspace Refresh bilingual README and landing copy around evidence-backed review, local boundaries, and V1.0.5 capabilities. Update public download metadata and links. --- README.md | 117 +++++++++++++++--------------------- README.zh-CN.md | 111 ++++++++++++++-------------------- meldwork-landing/index.html | 80 ++++++++++++------------ 3 files changed, 133 insertions(+), 175 deletions(-) diff --git a/README.md b/README.md index 0c945ae..7805fdd 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,3 @@ - -

Meldwork README banner

@@ -14,13 +6,13 @@ English · 简体中文

-# Meldwork — Local-first multi-agent orchestration for AI coding agents +# Meldwork — A local-first workspace for General Agents -**Coordinate Codex, Claude Code, Gemini CLI, and 9 more agent CLIs from one desktop workspace. Stop manually copying context between terminals — Meldwork freezes one task snapshot, sends it to every selected agent, captures their independent findings as evidence, and gates workspace writes behind your approval.** +**Turn several General Agents into a reviewable working group. Meldwork gives every task a shared context, lets selected Agents investigate independently or discuss across rounds, and keeps the evidence and human decision visible before anything is adopted.** -Meldwork is a local-first multi-agent orchestration desktop app for macOS (Apple silicon). It connects the AI coding agent CLIs you already have installed — Codex, Claude Code, Hermes, OpenCode, Gemini CLI, Qwen Code, Kimi Code, MiMo Code, Pi Agent, OpenClaw, OpenCodeReview, and WorkBuddy — into one reviewable workspace where you can run Direct sessions, Concurrent Responses (same task, multiple agents, independent replies), or Auto Discussion V4 (agents propose, challenge, negotiate responsibilities, and verify results across rounds). +Meldwork is a local-first Electron workspace for using the Agent tools you already have on your Mac. It supports focused conversations, independent concurrent responses, and Auto Discussion V4 for proposal, challenge, negotiated work, synthesis, and verification. Agents can work with text, files, images, media, Skills, and selected knowledge sources, so the same workspace can support research, analysis, writing, planning, review, and implementation. -Unlike terminal multiplexers (tmux, zellij) that show raw output side by side, Meldwork preserves every finding as structured evidence (Finding → Evidence → Decision → Disposition), keeps a human adoption gate before any file changes, and makes multi-agent work inspectable and reusable across sessions. +The product is organized around a durable review record: **Case → Finding → Evidence → Decision → Disposition**. Meldwork keeps the task snapshot, Agent contributions, run state, artifacts, Human Gates, and adoption decision together in one local work cell. Workspace writes are opt-in and remain under the user's control.

Download Meldwork V1.0.5 for Apple silicon macOS @@ -28,70 +20,49 @@ Unlike terminal multiplexers (tmux, zellij) that show raw output side by side, M · License

-## Who it is for +## What Meldwork is for -Use Meldwork when you: +Meldwork is useful when a decision benefits from more than one perspective and a clear record of why a result was adopted. Typical work includes: -- run multiple AI coding agents (Codex, Claude Code, Gemini CLI, Hermes, OpenCode, etc.) and want to coordinate them without manually passing context between terminals; -- need independent review for code, research, or product analysis before choosing a path; -- want to compare multiple agents' responses to the same task side by side, with evidence trails and a human approval gate before any workspace writes; -- need inspectable traces, evidence, and human review for multi-agent coding sessions — so you can resume, audit, and reuse work across sessions. +- research and information synthesis across local Agent tools and selected knowledge sources; +- product, market, operational, and technical analysis; +- writing, planning, review, and structured document work; +- multimodal work with local documents, images, audio, video, PDFs, and code or configuration files; +- implementation and review tasks where findings, evidence, permissions, and the final adoption decision should remain inspectable. -## Workflow +## How a task moves through Meldwork -1. **Select** the local Agents and participants. -2. **Scope** the goal, working directory, context, and permissions. -3. **Run** Direct, Concurrent Responses, or Auto Discussion V4. -4. **Review and adopt** the result, evidence, and any Human Gate before changing the workspace. +1. **Select** the Agents and participants for this Case. +2. **Scope** the goal, working directory, context, attachments, Skills, knowledge sources, and permissions. +3. **Run** a direct conversation, Concurrent Responses, or Auto Discussion V4. +4. **Review** the findings, evidence, artifacts, trace, and any Human Gate. +5. **Adopt** the approved result or leave the Case unresolved for further work. ## Collaboration modes | Mode | What happens | Best for | | --- | --- | --- | -| **Direct** | One selected Agent keeps its conversation and native session when supported. | Focused work with one Agent. | -| **Concurrent Responses** | Selected Agents receive the same frozen task snapshot and return independent replies in stable order. | Comparing approaches before choosing one. | -| **Auto Discussion V4** | The first round runs concurrent proposals. Later turns follow the discussion: one Agent can route the next turn with `@Agent`, or several Agents can be selected for a concurrent response. Native Agent sessions continue across rounds. | Multi-round work that benefits from discussion, flexible routing, and review. | +| **Direct** | One selected Agent keeps its conversation and native session when supported. | Focused research, writing, analysis, or execution. | +| **Concurrent Responses** | Selected Agents receive the same frozen task snapshot and return independent responses in stable order. | Comparing perspectives before choosing a path. | +| **Auto Discussion V4** | Agents propose, challenge, negotiate responsibilities, execute agreed work, synthesize a candidate result, and verify it across bounded rounds. Native Agent sessions continue when supported. | Multi-step work that needs discussion, division of responsibility, and review. | -Participants are always selected by the user. Automatic selection from a larger roster is outside the current preview. +Participants are selected by the user. Automatic selection from a larger roster is outside the current preview. -## How Meldwork differs +## The review record -Meldwork is a local-first multi-agent orchestration desktop app — not a terminal multiplexer, cloud agent fleet, communication network, or programmable orchestration framework. It connects the local Agent CLIs you already use to a decision-ready review workflow and keeps independent findings, evidence, responsibility, and the human adoption decision visible in one local workspace. +Meldwork treats collaboration as a decision process rather than a stream of chat messages: -If you're comparing Meldwork to other multi-agent orchestration tools, here's where it fits: +- **Case** defines the question, scope, context, and permissions. +- **Finding** records an Agent's claim, observation, or proposed action. +- **Evidence** links the finding to a response, artifact, file, knowledge result, or other bounded reference. +- **Decision** records what the evidence supports, what remains uncertain, and which path is selected. +- **Disposition** records whether the result was accepted, revised, rejected, superseded, or left unresolved. -| Tool | What it does | What Meldwork adds | -| --- | --- | --- | -| tmux / zellij | Terminal multiplexer — run agents in panes, manually copy context between them | Frozen task snapshots, evidence trails, human adoption gate, no manual context passing | -| Claude Code Agent Teams | Native subagent spawning within Claude Code only | Cross-CLI: mix Codex, Claude Code, Hermes, OpenCode and 8 more in one workspace | -| Claude Squad / amux / Conductor | Parallel agent runners with git worktree isolation | Evidence-backed review (Finding → Evidence → Decision → Disposition), not just parallel execution | -| CrewAI / AutoGen / LangGraph | Programmable multi-agent frameworks you build yourself | Ready-to-use desktop workflow — no orchestration code to write | -| Conductor (conductor.build) | macOS desktop for parallel Claude Code + Codex | Heterogeneous CLI support (12+ agents), evidence trails, human gate before writes | -| Emdash | Electron desktop for 22+ CLI agents | Decision traceability, evidence-aware runs, structured adoption records | -| Bernstein | Deterministic orchestrator with pre-merge verification | Human-in-the-loop adoption gate, not just automated CI checks | -| Buzz / Pragma / Paperclip | Agent communication / workflow / org management | Case-scoped independent judgments with evidence-backed decisions, not identity or org charts | -| Warp Oz / Devin / Factory / OpenHands Cloud | Cloud-hosted agent execution platforms | Runs locally in your Electron work cell with existing CLIs — no cloud dependency | +The Run Ledger preserves phase, participant, attempt, receipt, artifact, recovery, and Human Gate state. Diagnostic tool output and sensitive runtime details stay behind the Electron main-process boundary. -## See it in action +## General Agent catalog - - - - - - - - - - - -
Local Agent discoveryMulti-agent reviewDirect multimodal work
Meldwork local-first multi-agent workspace detecting Agent CLIsMeldwork multi-agent collaboration with evidence and human reviewMeldwork direct Agent workspace with local files and media
- -Example: give Codex, Claude Code, and Gemini CLI the same task — review a PR, analyze a bug, or compare implementation approaches. Meldwork freezes the task context, sends it to all three agents simultaneously, captures their independent findings as evidence, and lets you adopt only the result you approve. No manual context copying between terminals. - -## Supported local Agent CLIs - -Meldwork detects and invokes an installed command when its adapter and the CLI version are compatible: +Meldwork detects and invokes compatible locally installed Agent commands. The catalog currently includes: @@ -112,15 +83,21 @@ Meldwork detects and invokes an installed command when its adapter and the CLI v
-Approved Agent Connectors can be added through the [Agent Connector SDK](docs/agent-connector-sdk.md); custom executable Agents use the desktop custom-Agent path. See the [desktop guide](desktop/README.md) for the full adapter and capability matrix. +Approved Agent Connectors and custom executable Agents use the desktop connector paths. The [desktop guide](desktop/README.md) contains the current adapter, installation, provider, and capability matrix. -## Quick start +## Context and local boundaries -### Apple silicon macOS preview +Meldwork runs as a local Electron application. Conversations, group configuration, run records, and app-owned attachments stay in the local user data directory. The renderer receives only validated snapshots through a narrow preload API; executable paths, credentials, native session references, Skill paths, and unrestricted shell access remain in the main process. -Download [`Meldwork-0.1.5-arm64.dmg`](https://github.com/Ryder-MHumble/Meldwork/releases/download/Meldwork-V1.0.5/Meldwork-0.1.5-arm64.dmg) from the [official V1.0.5 prerelease](https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.5), move Meldwork to Applications, and install at least one supported local Agent CLI. The prerelease is ad-hoc signed and not notarized; macOS may require **Open Anyway** in **System Settings -> Privacy & Security** on first launch. +Selected Agents may send prompts, attachments, or Skills to their configured model Provider. Knowledge access is explicit and bounded: the current implementation supports local Obsidian retrieval and CLI-owned Feishu or DingTalk access modes. Local-first describes where Meldwork stores and coordinates work; it does not promise that a configured Agent Provider is offline. -### Run from source +## Download V1.0.5 + +For Apple silicon macOS, download the [Meldwork V1.0.5 prerelease](https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.5) and choose [`Meldwork-0.1.5-arm64.dmg`](https://github.com/Ryder-MHumble/Meldwork/releases/download/Meldwork-V1.0.5/Meldwork-0.1.5-arm64.dmg). The release also includes a ZIP archive and SHA-256 manifest. Install at least one supported local Agent CLI before opening the app. + +The preview artifacts are ad-hoc signed and not notarized with an Apple Developer ID. macOS may require **Open Anyway** under **System Settings → Privacy & Security** on first launch. + +## Run from source Prerequisites: Node.js `22.12+` and npm. @@ -139,16 +116,16 @@ npm --prefix frontend run build:desktop npm --prefix desktop test ``` -## Current boundary +## V1.0.5 -Meldwork is a local Electron desktop app for multi-agent orchestration and review — not a hosted agent fleet or a general agent framework. The current preview does not provide remote/cloud agent execution, automatic participant selection, enterprise SSO/RBAC/governance, or an Outcome Network. Local-first does not mean fully offline: a selected Agent may send prompts, attachments, or Skills to its configured Provider. Workspace writes are opt-in workflow controls, not an operating-system sandbox. +V1.0.5 improves local Agent readiness and recovery, preserves healthy participants when another Agent fails, keeps completed and stopped work visible after restart, and tightens group execution and output handling. It also updates the workspace preference flow, sidebar and titlebar details, and the Pi capability probe contract. -## Docs +Verification for this prerelease includes 343/343 frontend tests, 1,562/1,562 desktop tests, six deterministic evaluation cases with 18 results, web and desktop builds, packaging, ZIP integrity, deep code-signature verification, and packaged macOS acceptance for group execution, cancellation, and restart recovery. The artifacts remain ad-hoc signed and unnotarized; live behavior still depends on the installed Agent CLI version, authentication, Provider, and capabilities. + +## Documentation - [Architecture and product boundary](architecture.md) - [Desktop setup and Agent matrix](desktop/README.md) -- [Agent Connector SDK](docs/agent-connector-sdk.md) -- [AI discoverability index](docs/ai-discoverability.md) - [Contributing](CONTRIBUTING.md) - [Security policy](SECURITY.md) diff --git a/README.zh-CN.md b/README.zh-CN.md index 869babd..107f27a 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -1,11 +1,3 @@ - -

Meldwork README banner

@@ -14,11 +6,13 @@ English · 简体中文

-# Meldwork 为 AI Agent 构建组织层 +# Meldwork：本地优先的 General Agent 工作空间 -**多数工具是在帮人类管更多 Agent；Meldwork 解决的是另一件事：让多 Agent 协作变得可见、可追责、可复用。** +**把多个 General Agent 组织成一个可复核的工作小组。Meldwork 为每个任务建立共享上下文，让选定的 Agent 独立调查或分轮讨论，并在采用结果前保留完整的证据和人工决策。** -当前预览版是一个面向已支持本地 Agent CLI 的本地工作单元。它把参与者、上下文、协作边界、运行状态和人类复核放在同一个工作空间里。已选 Agent 现在可以并发回复，也可以围绕同一目标先独立提案，再根据讨论互相指定下一位参与者，最后协作完成工作并进行复核。 +Meldwork 是一个本地优先的 Electron 工作空间，用来连接你已经在电脑上使用的 Agent 工具。它支持直接会话、独立并发回复，以及包含提案、质询、职责协商、分工执行、整合和复核的 Auto Discussion V4。Agent 可以处理文字、文件、图片、音视频、Skill 和选定的知识源，因此同一个工作空间可以覆盖研究、分析、写作、规划、评审和实施。 + +产品围绕一条可持续复核的记录组织工作：**Case → Finding → Evidence → Decision → Disposition**。Meldwork 将任务快照、Agent 贡献、运行状态、产物、人工审批门和采用决定保存在同一个本地工作单元中。工作区写入默认受控，并由用户明确授权。

下载 Meldwork V1.0.5 Apple 芯片 macOS 版 @@ -26,68 +20,49 @@ · 许可证

-## 适合谁 +## Meldwork 适合什么工作 -当你有以下需求时，Meldwork 更适合： +当一个决定需要多个视角，并且需要留下清晰的采用依据时，Meldwork 更适合： -- 已经安装多个本地 Agent CLI，希望让同一任务跨 Agent 协作； -- 需要在代码评审、研究或产品分析中获得独立判断，再选择方案； -- 需要在写入工作区前检查可追溯的运行轨迹、证据并保留人工复核。 +- 研究与信息综合：结合本地 Agent 工具和明确选择的知识源； +- 产品、市场、运营和技术分析； +- 写作、规划、评审和结构化文档工作； +- 处理本地文档、图片、音频、视频、PDF、代码和配置文件的多模态工作； +- 需要保留发现、证据、权限、运行轨迹和最终采用决定的实施工作。 -## 工作流程 +## 一个任务如何在 Meldwork 中推进 -1. **选择**本地 Agent 和参与者。 -2. **限定**目标、工作目录、上下文和权限。 +1. **选择**本 Case 的 Agent 和参与者。 +2. **限定**目标、工作目录、上下文、附件、Skill、知识源和权限。 3. **运行**直接会话、并发回复或 Auto Discussion V4。 -4. **复核并采用**结果、证据和待处理的人工审批门（Human Gate），再写入工作区。 +4. **复核**发现、证据、产物、运行轨迹和人工审批门。 +5. **采用**批准的结果，或保留为待解决状态继续处理。 ## 协作模式 | 模式 | 运行方式 | 适合场景 | | --- | --- | --- | -| **直接会话** | 一个已选 Agent 在适配器支持时保持对话和原生会话。 | 使用单个 Agent 完成聚焦工作。 | -| **并发回复** | 已选 Agent 收到同一份冻结任务快照，并按稳定顺序返回独立回复。 | 在选择方案前比较不同路径。 | -| **Auto Discussion V4** | 首轮并发提案。后续轮次由 Agent 根据讨论结果通过最后一行的 `@Agent` 决定下一位参与者；@ 一个 Agent 时单独运行，@ 多个 Agent 时并发运行。每个 Agent 在同一任务中持续使用原生会话。 | 需要讨论、灵活分工和复核的多轮工作。 | +| **直接会话** | 一个已选 Agent 在适配器支持时保持对话和原生会话。 | 聚焦研究、写作、分析或执行。 | +| **并发回复** | 已选 Agent 收到同一份冻结任务快照，并按稳定顺序返回独立回复。 | 在选择方案前比较不同视角。 | +| **Auto Discussion V4** | Agent 先提出方案，再进行质询、职责协商、分工执行、候选结果整合和独立复核；支持时会在多轮中保持原生会话。 | 需要讨论、分工和复核的多步骤工作。 | -参与者始终由用户选择。从更大候选池自动选人不属于当前预览版。 +参与者始终由用户选择。从更大候选池自动选人组队不属于当前预览版。 -## Meldwork 与相邻产品的区别 +## 复核记录 -Meldwork 是面向多 Agent 评审与决策可追溯性的本地优先 AI Agent 工作空间，不是终端、云端 Agent Fleet、通信网络或可编程编排框架。它把你已经在使用的本地 Agent 工具连接到可形成决定的评审流程，并在一个本地工作单元中保留独立发现、证据、责任和人工采用决定。 +Meldwork 将协作组织成一套决策过程，而不是一串聊天消息： -| 项目 | 类别 | 主要解决什么 | Meldwork 的区别 | -| --- | --- | --- | --- | -| [Buzz](https://github.com/block/buzz) | Agent 通信网络 | 身份、频道、事件和持续协作。 | 面向单个 Case 的独立判断，以及有证据支持的 Decision 和 Disposition。 | -| [Pragma](https://github.com/pqpo/pragma) | 方法与工作流运行时 | 可复用的 Expert、Flow、Memory、Evaluation 和 DSL 资产。 | 在流程固定前保留分歧、复验和采用记录。 | -| [Munder Difflin](https://github.com/chaitanyagiri/munder-difflin) | 可视化 Agent 公司 | Boss -> Manager -> Workers，以及任务和活动状态。 | 追踪 Finding -> Evidence -> Decision -> Disposition，不让中心经理隐藏分歧。 | -| [Superset](https://github.com/superset-sh/superset) / [Conductor](https://www.conductor.build/) / [Vibe Kanban](https://github.com/BloopAI/vibe-kanban) | 并行编码工作台 | 并行 Coding Agent、隔离工作区、Diff 和 Merge。 | 面向异构 CLI 的本地优先评审，不以终端数量、Worktree 吞吐量或云 Sandbox 竞争。 | -| [cmux](https://github.com/manaflow-ai/cmux) | Agent 原生终端 | 低摩擦终端、通知和多任务处理。 | 增加冻结上下文、独立结果和人工采用门。 | -| [Nimbalyst](https://github.com/nimbalyst/nimbalyst) | Agent 与 Artifact 工作空间 | 并行 Agent，以及 Markdown、Mockup 和 Diagram。 | 在 Artifact 旁边保留证据和可追责的决定。 | -| [Paperclip](https://github.com/paperclipai/paperclip) | Agent 组织管理 | 公司、岗位、预算、审批和组织图。 | 将责任落在真实 Finding 和结果上，而不是虚拟公司。 | -| [MCP Agent Mail](https://github.com/Dicklesworthstone/mcp_agent_mail) | Agent 通信基础设施 | 身份、收件箱、Thread 和 advisory file lease。 | 在传输层之上保留 Case 和评审语义。 | -| LangGraph / CrewAI / AutoGen / OpenAI Agents SDK / Google ADK | 可编程多 Agent 框架 | 面向开发者的 Graph、角色、路由、工具和审批。 | 团队无需编写编排框架代码即可获得桌面评审流程。 | -| Warp Oz / Devin / Factory / OpenHands Cloud | 云端 Agent 控制面 | 托管 Sandbox、远程执行和 Agent Fleet。 | 在本地 Electron 工作单元中使用现有 CLI，并保持本地数据边界。 | +- **Case**：定义问题、范围、上下文和权限； +- **Finding**：记录 Agent 的判断、观察或行动建议； +- **Evidence**：将 Finding 连接到回复、产物、文件、知识结果或其他受约束的依据； +- **Decision**：记录证据支持的结论、未决问题和选定路径； +- **Disposition**：记录结果已接受、修订、拒绝、被替代或仍未解决。 -## 运行示例 +Run Ledger 会保留阶段、参与者、尝试、回执、产物、恢复状态和人工审批门。诊断工具输出与敏感运行信息留在 Electron 主进程边界内。 - - - - - - - - - - - -
本地 Agent 检测多 Agent 评审直接会话中的多模态工作
Meldwork 本地优先多 Agent 工作空间检测 Agent CLIMeldwork 多 Agent 协作、证据与人工复核Meldwork 直接 Agent 工作空间处理本地文件和媒体
+## General Agent 目录 -示例：把同一份变更评审上下文交给 Codex、Claude Code 和 Gemini CLI，比较各自的独立发现，再只采用你批准且有证据支持的结果。 - -## 支持的本地 Agent CLI - -当适配器和 CLI 版本兼容时，Meldwork 会检测并调用已安装的命令： +当适配器和 CLI 版本兼容时，Meldwork 会检测并调用已安装的 Agent 命令。当前目录包括： @@ -108,15 +83,21 @@ Meldwork 是面向多 Agent 评审与决策可追溯性的本地优先 AI Agent
-已批准的 Agent Connector 可通过 [Agent Connector SDK](docs/agent-connector-sdk.md) 接入；自定义可执行 Agent 使用桌面端的自定义 Agent 入口。完整适配器和能力矩阵见[桌面端指南](desktop/README.md)。 +已批准的 Agent Connector 和自定义可执行 Agent 使用桌面端的连接器入口。完整的适配器、安装、Provider 和能力矩阵见[桌面端指南](desktop/README.md)。 -## 快速开始 +## 上下文与本地边界 -### Apple 芯片 macOS 预览版 +Meldwork 作为本地 Electron 应用运行。对话、群组配置、运行记录和应用管理的附件保存在本地用户数据目录。渲染进程只通过受约束的 preload API 获取校验后的状态；可执行路径、凭据、原生会话引用、Skill 路径和任意 Shell 权限都留在主进程中。 -从[官方 V1.0.5 预发布页](https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.5)下载 [`Meldwork-0.1.5-arm64.dmg`](https://github.com/Ryder-MHumble/Meldwork/releases/download/Meldwork-V1.0.5/Meldwork-0.1.5-arm64.dmg)，将 Meldwork 移入“应用程序”，并至少安装一个受支持的本地 Agent CLI。该预发布版使用 ad-hoc 临时签名且未公证；首次启动时，macOS 可能要求你在“系统设置 -> 隐私与安全性”中选择“仍要打开 / Open Anyway”。 +选定的 Agent 仍可能把 Prompt、附件或 Skill 发送给其配置的模型 Provider。知识访问必须明确选择并受边界约束：当前实现支持本地 Obsidian 检索，以及由本地 CLI 管理的飞书或钉钉访问模式。Local-first 描述的是 Meldwork 的数据和协作位置，不代表已配置的 Agent Provider 一定离线。 -### 从源码运行 +## 下载 V1.0.5 + +Apple 芯片 macOS 用户请前往 [Meldwork V1.0.5 预发布页](https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.5)，下载 [`Meldwork-0.1.5-arm64.dmg`](https://github.com/Ryder-MHumble/Meldwork/releases/download/Meldwork-V1.0.5/Meldwork-0.1.5-arm64.dmg)。发布页同时提供 ZIP 压缩包和 SHA-256 校验文件。启动应用前，请至少安装一个受支持的本地 Agent CLI。 + +该预览版安装包使用 ad-hoc 临时签名，未使用 Apple Developer ID 签名，也未进行公证。macOS 首次启动时可能需要在“系统设置 → 隐私与安全性”中选择“仍要打开 / Open Anyway”。 + +## 从源码运行 前置条件：Node.js `22.12+` 和 npm。 @@ -135,16 +116,16 @@ npm --prefix frontend run build:desktop npm --prefix desktop test ``` -## 当前边界 +## V1.0.5 -Meldwork 是本地 Electron 应用，不是托管式 Agent Fleet，也不是通用 Agent 框架。当前预览版不提供远程、云端或频道 Agent 执行，不提供自动选人组队、企业 SSO/RBAC/治理或 Outcome Network。Local-first 不等于完全离线：选定的 Agent 仍可能把 Prompt、附件或 Skill（技能）发送到其配置的 Provider（模型服务商）。工作区写入是可选的工作流控制，不是操作系统级沙箱。 +V1.0.5 改进了本地 Agent 的就绪检测与恢复，在单个 Agent 失败时保留健康参与者，重启后继续显示已完成和已停止的工作，并加强了群组执行与结果导入。同时更新了工作区偏好、侧栏和标题栏细节，以及 Pi 能力探测契约。 + +本预览版已完成 343/343 前端测试、1,562/1,562 桌面端测试、6 个确定性评估场景共 18 条结果验证，并通过 Web 与桌面构建、打包、ZIP 完整性、深度代码签名校验，以及 Apple 芯片 macOS 上的群组执行、取消和重启恢复验收。安装包仍为 ad-hoc 临时签名且未公证；实际运行结果仍取决于本机 Agent CLI 版本、鉴权、Provider 和能力。 ## 文档 - [架构与产品边界](architecture.md) - [桌面端设置与 Agent 矩阵](desktop/README.md) -- [Agent Connector SDK](docs/agent-connector-sdk.md) -- [AI 可发现性索引](docs/ai-discoverability.md) - [贡献指南](CONTRIBUTING.md) - [安全策略](SECURITY.md) diff --git a/meldwork-landing/index.html b/meldwork-landing/index.html index 1e608ce..84231d5 100644 --- a/meldwork-landing/index.html +++ b/meldwork-landing/index.html @@ -3,17 +3,17 @@ - Meldwork — Multi-Agent Orchestration for AI Coding Agents | Local-First Desktop Workspace - - - - + Meldwork — A Local-First Workspace for General Agents + + + + - - + + @@ -28,13 +28,13 @@ "name": "Meldwork", "applicationCategory": "DeveloperApplication", "operatingSystem": "macOS (Apple silicon)", - "softwareVersion": "1.0.4", - "description": "Meldwork is a local-first multi-agent orchestration desktop app for AI coding agents. It coordinates Codex, Claude Code, Gemini CLI, Hermes, OpenCode and 7 more agent CLIs from one workspace — freezing task context, capturing independent findings as evidence, and putting a human adoption gate before any workspace change. Unlike terminal multiplexers that require manual context copying between agents, Meldwork sends one frozen task snapshot to every selected agent and preserves their responses as structured evidence.", - "featureList": "Multi-agent orchestration across 12+ CLI agents, Concurrent Responses mode, Auto Discussion V4 with proposal-challenge-negotiate-verify workflow, Frozen task snapshots, Evidence Trail (Finding → Evidence → Decision → Disposition), Human Gate for workspace writes, Direct mode with native session continuity, Local-first Electron desktop, Agent Connector SDK, Supports Codex/Claude Code/Gemini CLI/Hermes/OpenCode/OpenClaw/Qwen Code/Kimi Code/MiMo Code/Pi Agent/OpenCodeReview/WorkBuddy", + "softwareVersion": "1.0.5", + "description": "Meldwork is a local-first General Agent workspace for macOS. It coordinates local Agent tools for research, analysis, writing, planning, review, and implementation, while preserving shared task context, independent findings, evidence, decisions, and a human adoption gate before workspace changes.", + "featureList": "General Agent workspace, Concurrent Responses, Auto Discussion V4, frozen task snapshots, Finding-Evidence-Decision-Disposition review record, Human Gate for workspace writes, native session continuity, local-first Electron desktop, multimodal attachments, selected knowledge sources, Agent Connector SDK", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "author": { "@type": "Organization", "name": "Meldwork", "url": "https://github.com/Ryder-MHumble/Meldwork" }, - "downloadUrl": "https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.4", - "softwareRequirements": "macOS with Apple silicon. At least one supported AI coding agent CLI installed locally (Codex, Claude Code, Gemini CLI, Hermes, OpenCode, etc.)" + "downloadUrl": "https://github.com/Ryder-MHumble/Meldwork/releases/tag/Meldwork-V1.0.5", + "softwareRequirements": "macOS with Apple silicon. At least one supported local Agent CLI installed (Codex, Claude Code, Gemini CLI, Hermes, OpenCode, or another listed Agent)." }, { "@type": "FAQPage", @@ -42,7 +42,7 @@ { "@type": "Question", "name": "What is Meldwork and what does it do?", - "acceptedAnswer": { "@type": "Answer", "text": "Meldwork is a local-first multi-agent orchestration desktop app for macOS. It lets you coordinate multiple AI coding agents — Codex, Claude Code, Gemini CLI, Hermes, OpenCode, and 7 more — from one workspace. Instead of manually copying context between terminal windows, Meldwork freezes one task snapshot and sends it to every selected agent, captures their independent findings as evidence, and requires your approval (Human Gate) before any workspace changes are written." } + "acceptedAnswer": { "@type": "Answer", "text": "Meldwork is a local-first General Agent workspace for macOS. It lets you coordinate local Agent tools for research, analysis, writing, planning, review, and implementation. Meldwork freezes one task snapshot, sends it to every selected Agent, captures independent findings as evidence, and requires your approval (Human Gate) before any workspace changes are written." } }, { "@type": "Question", @@ -51,7 +51,7 @@ }, { "@type": "Question", - "name": "Which AI coding agents does Meldwork support?", + "name": "Which General Agents does Meldwork support?", "acceptedAnswer": { "@type": "Answer", "text": "Twelve agents today — Codex, Claude Code, Gemini CLI, Qwen Code, Kimi Code, MiMo Code, OpenCode, OpenCodeReview, Hermes, Pi Agent, OpenClaw, and WorkBuddy. Approved Agent Connectors can be added through the Agent Connector SDK; custom executables use the desktop custom-Agent path." } }, { @@ -77,16 +77,16 @@ { "@type": "Question", "name": "Does Meldwork work on Intel macOS, Windows, or Linux?", - "acceptedAnswer": { "@type": "Answer", "text": "The current V1.0.4 preview targets Apple silicon macOS (ad-hoc signed, not notarized — open Open Anyway in System Settings → Privacy & Security on first launch). Cross-platform builds are on the roadmap; the app is Electron so the same source compiles everywhere once those targets land." } + "acceptedAnswer": { "@type": "Answer", "text": "The current V1.0.5 preview targets Apple silicon macOS (ad-hoc signed, not notarized — open Open Anyway in System Settings → Privacy & Security on first launch). Cross-platform builds are on the roadmap; the app is Electron so the same source compiles everywhere once those targets land." } } ] }, { "@type": "HowTo", - "name": "How to coordinate multiple AI coding agents with Meldwork", - "description": "Steps to use Meldwork to orchestrate Codex, Claude Code, and other agent CLIs on one task without manually copying context between terminals.", + "name": "How to coordinate General Agents with Meldwork", + "description": "Steps to use Meldwork to coordinate local General Agents on one Case with shared context, evidence, and a human adoption decision.", "step": [ - { "@type": "HowToStep", "name": "Select agents", "text": "Open Meldwork and select the local AI agents you want to participate — e.g., Codex, Claude Code, and Gemini CLI." }, + { "@type": "HowToStep", "name": "Select Agents", "text": "Open Meldwork and select the local General Agents you want to participate — for example Codex, Claude Code, and Gemini CLI." }, { "@type": "HowToStep", "name": "Scope the task", "text": "Define the goal, working directory, context, and permissions. Meldwork freezes this as a task snapshot." }, { "@type": "HowToStep", "name": "Run collaboration mode", "text": "Choose Direct (one agent), Concurrent Responses (all agents get the same frozen snapshot and respond independently), or Auto Discussion V4 (agents propose, challenge, negotiate, and verify)." }, { "@type": "HowToStep", "name": "Review and adopt", "text": "Inspect each agent's findings, evidence, and any Human Gate prompts. Adopt only the result you approve — workspace writes are opt-in." } @@ -124,8 +124,8 @@ How it differs FAQ - - Download V1.0.4 + + Download V1.0.5
-

Meldwork is a local-first multi-agent orchestration desktop app for AI coding agents. It coordinates the agent CLIs you already run — Codex, Claude Code, Gemini CLI, and 9 more — from one workspace. Instead of manually copying context between terminals, Meldwork freezes one task snapshot, sends it to every selected agent, captures their independent findings as evidence, and puts a human adoption gate before any workspace change.

+

Meldwork is a local-first General Agent workspace for macOS. It coordinates the Agent tools you already run from one workspace for research, analysis, writing, planning, review, and implementation. Meldwork freezes one task snapshot, captures independent findings as evidence, and puts a human adoption gate before any workspace change.

  • @@ -629,7 +629,7 @@
  • @@ -669,7 +669,7 @@
    -

    The current V1.0.4 preview targets Apple silicon macOS (ad-hoc signed, not notarized — open Open Anyway in System Settings → Privacy & Security on first launch). Cross-platform builds are on the roadmap; the app is Electron so the same source compiles everywhere once those targets land.

    +

    The current V1.0.5 preview targets Apple silicon macOS (ad-hoc signed, not notarized — open Open Anyway in System Settings → Privacy & Security on first launch). Cross-platform builds are on the roadmap; the app is Electron so the same source compiles everywhere once those targets land.

    • @@ -686,11 +686,11 @@