快速开始

5 分钟内让 Forgexa 跑起来。

前置条件

• Docker & Docker Compose
• Git
• 已安装以下任一 AI Agent CLI：Claude Code、Codex 或 OpenCode

1. 克隆并启动

git clone <your-repo-url> forgexa
cd forgexa

# 启动所有服务 (API, Web, PostgreSQL, Redis, MinIO)
docker compose up -d

Web UI 地址：http://localhost:3000，API 地址：http://localhost:8000。

2. 登录

默认管理员账号：

• 邮箱：admin@example.com
• 密码：admin123

# 推荐使用 Forgexa CLI 登录
forgexa login --server http://localhost:8000 --email admin@example.com --password admin123

3. 创建组织

登录后，创建一个组织来管理团队：

1. 点击左上角组织选择器
2. 点击 创建组织
3. 输入组织名称（如 "我的团队"）
4. 创建完成后你自动成为组织 Owner

TIP

组织是最顶层容器。在组织内创建工作空间来组织项目。

4. 启动守护进程

守护进程运行在宿主机上，执行 AI Agent 任务：

# 设置环境变量
export DAEMON_SERVER_URL=http://localhost:8000
export DAEMON_API_TOKEN=<your-token>

# 启动守护进程
forgexa daemon start

守护进程会：

1. 发现已安装的 Agent CLI（claude、codex、opencode、gemini）
2. 注册到 API 服务器
3. 开始轮询任务

5. 创建项目

1. 打开 Web UI → 选择工作空间 → 项目 → 新建项目
2. 填写项目信息：
   • 名称、项目缩写
   • 技术栈（如 ["python", "fastapi"]）
   • Git 仓库 URL（可选）
3. 保存

6. 提交需求

1. 进入项目 → 需求 → 新建需求
2. 输入自然语言需求：

   "创建一个用户注册的 REST API 端点，包含邮箱验证和密码哈希"

3. 点击 分析 — AI 将生成结构化规格说明
4. 审核并 批准 需求

7. 生成并执行计划

1. 需求审批后，点击 生成计划
2. 审核生成的计划（工作项、执行节点）
3. 点击 批准计划 — 确认执行计划
4. 如果有在线守护进程，执行将自动开始

8. 监控执行

• 执行 页面 — 观察流水线进度（设计 → 编码 → 测试 → 评审）
• 看板 页面 — 在看板列中跟踪工作项
• 门禁 页面 — 在提示时审核和批准质量门禁

下一步

• 组织管理 — 管理团队、邀请、预算
• 安装部署 — 详细的部署选项
• 基本工作流 — 深入了解开发生命周期
• WORKFLOW.md 配置 — 自定义 Agent 行为