Back to Details

worktree-setup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Worktree Setup

Worktree 搭建

Preferred: Use Branchlet

推荐方案：使用 Branchlet

The repo has a 
.branchlet.json
config — it handles env file copying, dependency installation, and Prisma generation automatically.
bash
npm install -g branchlet                                      # install once
branchlet create -n <name> -s <source-branch> -b <new-branch>
branchlet list --json   # list all worktrees
仓库中包含
.branchlet.json
配置文件——它会自动处理环境文件复制、依赖安装和Prisma生成操作。
bash
npm install -g branchlet                                      # 仅需安装一次
branchlet create -n <名称> -s <源分支> -b <新分支>
branchlet list --json   # 列出所有worktree

Manual Fallback

手动备选方案

If branchlet isn't available:
  1. git worktree add ../<RepoName><N> <branch-name>
  2. Copy 
    .env
    files: 
    backend/.env
    , 
    frontend/.env
    , 
    autogpt_platform/.env
    , 
    db/docker/.env
  3. Install deps: 
    • cd autogpt_platform/backend && poetry install && poetry run prisma generate
    • cd autogpt_platform/frontend && pnpm install
若无法使用Branchlet：
  1. git worktree add ../<仓库名><N> <分支名称>
  2. 复制.env文件：
    backend/.env
    、
    frontend/.env
    、
    autogpt_platform/.env
    、
    db/docker/.env
  3. 安装依赖： 
    • cd autogpt_platform/backend && poetry install && poetry run prisma generate
    • cd autogpt_platform/frontend && pnpm install

Running the App

启动应用

Free ports first — backend uses: 8001, 8002, 8003, 8005, 8006, 8007, 8008.
bash
for port in 8001 8002 8003 8005 8006 8007 8008; do
  lsof -ti :$port | xargs kill -9 2>/dev/null || true
done
cd <worktree>/autogpt_platform/backend && poetry run app
先释放端口——后端使用的端口为：8001、8002、8003、8005、8006、8007、8008。
bash
for port in 8001 8002 8003 8005 8006 8007 8008; do
  lsof -ti :$port | xargs kill -9 2>/dev/null || true
done
cd <worktree目录>/autogpt_platform/backend && poetry run app

CoPilot Testing Gotcha

CoPilot 测试注意事项

SDK mode spawns a Claude subprocess — won't work inside Claude Code. Set 
CHAT_USE_CLAUDE_AGENT_SDK=false
in 
backend/.env
to use baseline mode.
SDK模式会启动Claude子进程——在Claude Code中无法运行。请在
backend/.env
中设置
CHAT_USE_CLAUDE_AGENT_SDK=false
以使用基础模式。