After the extension is installed and you are signed in, choose the repository folder that should receive packet files and local SwarmCraft workflow updates.
Choose the right workspace folder
Use SwarmCraft: Choose Repo and select the workspace folder that owns the project you want to build.
This matters most in multi-root workspaces, where several repositories can be open at once.
What the extension creates
SwarmCraft stores packet files under .swarmcraft/projects/ in the selected repository. Those files carry the ticket goal, staged checklist work, notes, and agent updates used during delivery.
What stays synced
The extension watches the packet files inside the selected workspace folder and syncs supported changes back into SwarmCraft. That gives the web board and the local repository a shared workflow state.
Before you move on
Confirm that:
- you can see the SwarmCraft view in VS Code
- the correct workspace folder is selected
- the extension can open board routes in the browser
Once the project is connected, you are ready to Start your first discovery chat.
If you want SwarmCraft to prepare packets and run a whole board from the terminal, use the CLI install guide after the repository is connected.