emdash

环境要求

• macOS、Windows 或 Linux（x64/ARM64）桌面系统
• macOS 使用 Homebrew 安装时需已装 Homebrew
• 本机已安装至少一个 CLI 编码智能体（如 Claude Code、Codex、OpenCode、Amp）
• 待处理的本地项目需为 Git 仓库（每个任务在独立 Git worktree 中运行）
• 如需在远程机器上运行，需准备好可通过 SSH/SFTP 访问的主机

安装与启动步骤

1. 1确认系统平台

   先确定自己的操作系统与芯片架构：macOS 分 Apple Silicon 和 Intel，Linux 分 x64 和 ARM64，选错安装包无法运行。

2. 2macOS 安装

   Homebrew 用户一条命令即可安装；也可直接下载 Apple Silicon 或 Intel 的 dmg 安装包。

   brew install --cask emdash

   复制

3. 3Windows 安装

   从 Releases 下载 Installer（.msi）双击安装，或下载 Portable（.exe）免安装直接运行。

4. 4Linux 安装

   按架构下载 AppImage、DEB 或 RPM：x64 与 ARM64 的包名不同，请对照安装表选择。

5. 5准备 CLI 智能体

   Emdash 本身不内置模型，需先在系统里装好并登录你常用的 CLI 智能体，如 Claude Code、Codex、OpenCode、Amp。

6. 6启动并打开项目

   打开 Emdash，导入本地 Git 项目，为每个任务创建独立 worktree 与分支，并行运行多个智能体。

7. 7配置远程机器（可选）

   若代码在远端，可通过 SSH/SFTP 连接远程机器，在远程环境里同样并行运行智能体。

如何确认成功

Emdash 桌面应用正常启动进入主界面，能打开本地 Git 项目并成功发起一个智能体任务即为成功。

常见问题

注意事项

• 每个任务运行在独立的 Git worktree 和分支上，项目本身必须是 Git 仓库才能使用该隔离能力。
• macOS 的 brew 安装方式仅在 README 中给出，Windows 与 Linux 需从 Releases 页面下载对应安装包。
• Linux 用户注意区分 x64 与 ARM64 安装包，AppImage、DEB、RPM 三种格式按发行版选择。
• 安装包统一在 GitHub Releases 最新版本页面获取，下载链接以该页面为准。