快速开始
安装
下载安装包并完成首次启动
下载安装包
从 GitHub Releases 下载对应平台的安装包：
- Apple Silicon：yoda-arm64.dmg
- Intel：yoda-x64.dmg
拖入「应用程序」文件夹后启动即可。
在 Releases 页面下载 MSI 或 EXE 安装包，按向导完成安装。
提供 AppImage、.deb 和 .rpm 三种格式，在 Releases 页面选择适合你发行版的包。
前置条件
Yoda 本身开箱即用，但要让 agent 真正干活，你需要：
- git —— worktree 隔离依赖 git，确保
git --version可用 - 至少一个 Runtime CLI —— 例如 Claude Code 或 Codex CLI，并完成各自的登录认证。详见 接入 Runtime
Yoda 不内置任何模型 API Key——它编排的是你本机已安装、已认证的 Runtime CLI。agent 能在终端里跑起来，就能在 Yoda 里跑起来。
从源码运行（开发者）
git clone https://github.com/lovstudio/yoda.git
cd yoda
pnpm run d # 安装依赖并启动开发模式要求 Node.js ≥ 24、pnpm ≥ 10。常用命令：
| 命令 | 用途 |
|---|---|
pnpm run d | 安装依赖 + 启动开发模式 |
pnpm run dev | 重启开发模式 |
pnpm run build | 构建 Electron 应用 |
pnpm run rebuild | 重建原生依赖（better-sqlite3、node-pty） |
下一步
安装完成后，跟着 第一个任务 十分钟跑通完整流程。