文档

你需要准备

SuperDevSpace 驱动的是你已经在用的智能体 CLI。首次运行前，请准备好：

• 搭载 Apple 芯片、运行 macOS 13 Ventura 或更高版本的 Mac，64 位 Windows 10 或 11，或 64 位 Linux（Ubuntu 22.04+、Debian 12+、Fedora 38+）。
• Git，以及你想让团队处理的仓库，已克隆到本地。
• 至少一个已安装并登录的智能体 CLI — Claude Code、OpenAI Codex、Gemini CLI、Aider、Qwen Code、Cursor CLI 或 OpenCode。应用会检查找到了哪些，并告诉你其余几个的安装命令。
• 该 CLI 的订阅或 API key。它只在你和服务提供方之间；SuperDevSpace 永远看不到它，也从不转售模型访问权。

安装并登录

从下载页获取安装程序，页面会显示已发布哪些版本。macOS 版（Apple 芯片）已签名、已公证，并会自动更新。Windows 安装程序目前是尚未代码签名的 beta 版，所以 SmartScreen 会询问一次（更多信息 › 仍要运行）。Linux 上可以选择 AppImage（会自动更新），或适合你包管理器的 .deb / .rpm。每个发布的文件都列出了 SHA-256，你可以在打开前先校验。

首次运行时需要创建账户或登录（邮箱、Google、GitHub 或 Apple）。新账户会开始 14 天 Premium 试用，无需绑卡。账户只保存你的订阅和设备列表 — 与你的代码无关。

你的第一个组织

在 SuperDevSpace 里，每个仓库就是一个组织：有自己的团队、看板和记忆。欢迎面板会带你完成三步：

1. 添加组织：起个名字，并指向仓库所在的文件夹。
2. 组建团队：选择角色（前端、后端、QA、审阅者、设计师等），给每个智能体起名，愿意的话再加些额外指令。之后还可以继续添加。
3. 启动 manager。它会作为一个真实的智能体 CLI 会话，在你能看到、也能输入的终端标签页中打开。

下达指令

用大白话告诉 manager 你想要什么 — 在它的终端或聊天里输入，或者直接口述。Manager 会像一位技术负责人那样行事：

1. 开启 sprint，把指令拆成看板上的任务，每个任务附一段简短说明。
2. 为每个任务雇用一个 worker。每个 worker 都是独立的 CLI 会话，有自己的终端标签页，以及位于自己 branch 上的 git worktree。
3. 审阅每个 worker 的报告，把 branch squash merge 进你的主线，发现问题时要求修复。
4. 最后交给你一份汇总报告。

你随时可以介入：每个智能体都有聊天视图和它真实的终端，每处改动都会以 diff 的形式显示在产生它的对话旁边。

Worktree 与初始化脚本

Worker 之间从不共享同一份 checkout。每个 worker 都会在应用自己的数据目录（而不是你的仓库里）获得一个 git worktree，每一轮完成后都会 commit 到该 worker 的 branch 上，所以不会有任何内容只存在于未提交的文件夹里。

新建的 worktree 里只有 git 跟踪的文件。如果你的仓库里有 .super/scripts/setup-worktree.sh，应用会在每个新 worktree 中、worker 启动前运行它，并让 SUPERDEV_MAIN_REPO 指向你的主 checkout。Submodule 会自动为你初始化。

              #!/usr/bin/env bash
set -euo pipefail
# Copy local-only files from the main checkout
cp "$SUPERDEV_MAIN_REPO/.env" .env 2>/dev/null || true
# Install dependencies
pnpm install --frozen-lockfile
            

审批与提问

当智能体需要做决定时 — 一个权限提示、两种方案二选一 — 它会问你，而不是自己猜。问题会显示在工作区顶部，直到你回答为止。

一款能查看同样的看板、智能体和待回答问题的手机伴侣应用即将登陆 App Store；目前它是仅限受邀的 beta。

指着网页就能修

在浏览器面板中打开你应用的 dev server，选中一个元素。Inspector 会显示光标下的组件链，以及每个组件的文件和行号，并把元素、截图和你的备注一起发给智能体。支持 Vite、Next.js 和静态网站。

选择 CLI

CLI 按组织选择。目前应用对 Claude Code 的支持最完整 — hooks、resume、MCP 工具和权限应答。其余六种可以启动和运行；应用会把它们标为实验性，并告诉你哪些附加功能尚未接入，而不是悄无声息地失败。

哪些数据会离开你的电脑

智能体作为本地进程运行，操作的是你本地的仓库。你的源码、prompt、终端输出和文件路径从不发送到我们的服务器。账户服务只保存账户、订阅状态和设备列表；隐私政策列出了每一个字段。