Emdash 是一个与提供商无关的桌面应用程序，允许您并行运行多个编程代理 (Coding Agents)，每个代理都在其独立的 git worktree（工作树）中隔离运行，既可以在本地，也可以通过 SSH 在远程机器上运行。我们称之为代理开发环境 (Agentic Development Environment, ADE)。

Emdash 支持 23 个 CLI 代理，包括 Claude Code、Qwen Code、Hermes Agent、Amp 和 Codex。用户可以直接将 Linear、GitHub 或 Jira 工单传递给代理，审查差异 (diffs)、测试更改、创建 PR（拉取请求）、查看 CI/CD（持续集成/持续部署）检查以及合并代码。

通过 SSH 在远程服务器上开发

通过 SSH/SFTP 连接到远程机器以处理远程代码库。Emdash 支持 SSH agent 和密钥认证，并将凭据安全地存储在你的操作系统钥匙串 (keychain) 中。使用与本地开发相同的并行工作流在远程项目上运行代理。了解更多

安装

macOS

• Apple Silicon: https://github.com/generalaction/emdash/releases/latest/download/emdash-arm64.dmg
• Intel x64: https://github.com/generalaction/emdash/releases/latest/download/emdash-x64.dmg

macOS 用户也可以：brew install --cask emdash

Windows

• 安装程序 (x64): https://github.com/generalaction/emdash/releases/latest/download/emdash-x64.msi
• 便携版 (x64): https://github.com/generalaction/emdash/releases/latest/download/emdash-x64.exe

Linux

• AppImage (x64): https://github.com/generalaction/emdash/releases/latest/download/emdash-x86_64.AppImage
• Debian 包 (x64): https://github.com/generalaction/emdash/releases/latest/download/emdash-amd64.deb

发行版概览

最新发行版 (macOS • Windows • Linux)

提供商

支持的 CLI（命令行界面）提供商

Emdash 目前支持 23 个 CLI（命令行界面）提供商，并且我们正定期添加新的。如果您发现遗漏了某个提供商，请告知我们或创建一个 PR（拉取请求）。

CLI 提供商	状态	安装
Amp	✅ 已支持	npm install -g @sourcegraph/amp@latest
Auggie	✅ 已支持	npm install -g @augmentcode/auggie
Autohand Code	✅ 已支持	npm install -g autohand-cli
Charm	✅ 已支持	npm install -g @charmland/crush
Claude Code	✅ 已支持	curl -fsSL https://claude.ai/install.sh | bash
Cline	✅ 已支持	npm install -g cline
Codebuff	✅ 已支持	npm install -g codebuff
Codex	✅ 已支持	npm install -g @openai/codex
Continue	✅ 已支持	npm i -g @continuedev/cli
Cursor	✅ 已支持	curl https://cursor.com/install -fsS | bash
Droid	✅ 已支持	curl -fsSL https://app.factory.ai/cli | sh
Gemini	✅ 已支持	npm install -g @google/gemini-cli
GitHub Copilot	✅ 已支持	npm install -g @github/copilot
Goose	✅ 已支持	curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
Hermes Agent	✅ 已支持	curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Kilocode	✅ 已支持	npm install -g @kilocode/cli
Kimi	✅ 已支持	uv tool install kimi-cli
Kiro (AWS)	✅ 已支持	curl -fsSL https://cli.kiro.dev/install | bash
Mistral Vibe	✅ 已支持	curl -LsSf https://mistral.ai/vibe/install.sh | bash
OpenCode	✅ 已支持	npm install -g opencode-ai
Pi	✅ 已支持	npm install -g @mariozechner/pi-coding-agent
Qwen Code	✅ 已支持	npm install -g @qwen-code/qwen-code
Rovo Dev	✅ 已支持	acli rovodev auth login

问题

Emdash 允许您将来自 Linear、GitHub 或 Jira 的工单直接传递给您的编码代理（Coding Agent）。

工具	状态	认证
Linear	✅ 已支持	使用 Linear API（应用程序接口）密钥进行连接。
Jira	✅ 已支持	提供您的站点 URL、电子邮件和 Atlassian API 令牌。
GitHub Issues	✅ 已支持	通过 GitHub CLI（gh auth login）进行认证。

贡献指南

欢迎参与贡献！请参阅 贡献指南 以开始，并加入我们的 Discord 社区进行交流。

常见问题解答 (FAQ)

你们收集哪些遥测数据 (Telemetry)，我可以禁用它吗？

我们向 PostHog 发送 匿名、白名单事件（应用启动/关闭、功能使用名称、应用/平台版本）。
我们 不会 发送代码、文件路径、仓库名称、提示词或个人身份信息 (PII)。

禁用遥测：

• 在应用中：设置 → 常规 → 隐私与遥测（关闭开关）
• 或在启动前通过环境变量 (env var)：

TELEMETRY_ENABLED=false

完整详情：请参阅 docs/telemetry.md。

我的数据存储在哪里？

应用数据是本地优先 (Local-first)。我们将应用状态存储在本地 SQLite 数据库中：

macOS:   ~/Library/Application Support/emdash/emdash.db
Windows: %APPDATA%\emdash\emdash.db
Linux:   ~/.config/emdash/emdash.db

隐私说明： 虽然 Emdash 本身将数据存储在本地，但 当你使用任何编码代理 (Coding Agent)（如 Claude Code、Codex、Qwen 等）时，你的代码和提示词会被发送到该提供商的云 API 服务器进行处理。每个提供商都有自己的数据处理和保留政策。

你可以通过删除它来重置本地数据库（请先退出应用）。文件将在下次启动时重新创建。

我需要 GitHub CLI 吗？

仅当你想要使用 GitHub 功能时（从 Emdash 打开拉取请求 (PR)、获取仓库信息、GitHub Issues 集成）。
安装并登录：

gh auth login

如果你不使用 GitHub 功能，可以跳过安装 gh。

如何添加新的提供商？

Emdash 是 提供商无关 (Provider-agnostic) 的，旨在快速添加命令行界面 (CLI)。

• 按照 贡献指南 (CONTRIBUTING.md) 提交 PR。
• 包括：提供商名称、调用方式（CLI 命令）、认证说明以及最小化设置步骤。
• 我们将把它添加到 集成 矩阵中，并在用户界面 (UI) 中配置提供商选择。

如果你不确定从哪里开始，请带着 CLI 的链接和典型命令打开一个 Issue。

我遇到了原生模块崩溃（sqlite3 / node‑pty / keytar）。有什么快速修复方法？

这通常发生在切换 Node/Electron 版本之后。

1. 重建原生模块：

npm run rebuild

2. 如果失败，清理并重新安装：

npm run reset

（重置 node_modules，重新安装，并重新构建 Electron 原生依赖。）

Emdash 需要哪些权限？

• 文件系统/Git： 用于读写你的仓库并为隔离创建 Git 工作树 (Worktrees)。
• 网络： 仅用于你选择使用的提供商 CLI（例如 Codex、Claude）和可选的 GitHub Actions。
• 本地数据库： 用于在你的机器上将应用状态存储在 SQLite 中。

Emdash 本身 不会 将你的代码或聊天记录发送到任何服务器。第三方 CLI 可能会根据其政策传输数据。

我可以通过 SSH 处理远程项目吗？

是的！ Emdash 支持通过 SSH 进行远程开发。

设置：

1. 前往 设置 → SSH 连接 并添加你的服务器详情
2. 选择认证方式：SSH 代理 (SSH agent)（推荐）、私钥或密码
3. 添加远程项目并指定服务器上的路径

要求：

• 对远程服务器的 SSH 访问权限
• 远程服务器上已安装 Git
• 对于代理认证：运行 SSH 代理并加载了你的密钥 (ssh-add -l)

请参阅 docs/ssh-setup.md 获取详细设置说明，参阅 docs/ssh-architecture.md 获取技术细节。

emdash 快速上手指南

emdash 是一个与供应商无关的桌面应用，旨在构建代理开发环境（ADE）。它允许你在本地或通过 SSH 远程连接，并行运行多个编码代理（Coding Agents），每个代理都在独立的 git worktree 中隔离运行。

1. 环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统: macOS (Intel/Apple Silicon), Windows (x64), 或 Linux (x64)。
• Git: 必须安装，用于创建隔离的 git worktrees。
• Node.js & npm: 许多支持的 CLI 代理需要通过 npm 安装。
• SSH 客户端 (可选): 如果您计划使用远程服务器开发功能。
• 网络: 部分代理（如 Claude Code, Codex）需要访问外部 API。

2. 安装步骤

根据您的操作系统选择一种方式安装 emdash 主程序。

macOS

推荐使用 Homebrew 安装，也可下载 DMG 文件。

brew install --cask emdash

或直接下载最新 Release：

• Apple Silicon: emdash-arm64.dmg
• Intel x64: emdash-x64.dmg

Windows

• 安装程序 (x64): emdash-x64.msi
• 便携版 (x64): emdash-x64.exe

Linux

• AppImage (x64): emdash-x86_64.AppImage
• Debian 包 (x64): emdash-amd64.deb

3. 基本使用

emdash 本身是一个调度器，您需要先配置至少一个编码代理（CLI Provider）才能开始工作。

第一步：安装编码代理

emdash 支持 23 种 CLI 代理。以下是两个常用代理的安装示例：

Claude Code:

curl -fsSL https://claude.ai/install.sh | bash

Qwen Code:

npm install -g @qwen-code/qwen-code

(其他代理如 Codex, Cline, GitHub Copilot 等请参考官方文档安装)

第二步：启动项目

1. 打开 emdash 应用程序。
2. 点击添加项目，选择本地代码库路径。
3. 若需远程开发，可在设置中添加 SSH 连接信息，直接操作远程服务器上的代码库。

第三步：运行代理

1. 在项目界面中选择已安装的代理（例如 Claude Code 或 Qwen Code）。
2. 输入指令或将任务票证（来自 Linear, GitHub, Jira）传递给代理。
3. 代理将在独立的 git worktree 中执行代码修改、测试和提交。

第四步：审查与合并

1. 在 emdash 界面中查看代理生成的 Diff。
2. 确认更改无误后，可直接创建 Pull Request 并合并代码。
3. 支持查看 CI/CD 检查状态。

---

更多详细配置及隐私政策请参阅官方文档。