Worktree Setup
Preferred: Use Branchlet
The repo has a .branchlet.json config — it handles env file copying, dependency installation, and Prisma generation automatically.
npm install -g branchlet # install once branchlet create -n <name> -s <source-branch> -b <new-branch> branchlet list --json # list all worktrees
Manual Fallback
If branchlet isn't available:
-
git worktree add ../<RepoName><N> <branch-name>
-
Copy .env files: backend/.env , frontend/.env , autogpt_platform/.env , db/docker/.env
-
Install deps:
-
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.
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
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.