SwarmCraft

SwarmCraft brings your project board and packet workflow into VS Code so you can pull work from the board, create linked packet files in your repository, keep updates in sync, and jump into the matching web views when needed.

Install

1. Download VS Code from https://code.visualstudio.com/download.
2. Install SwarmCraft from the Marketplace: https://marketplace.visualstudio.com/items?itemName=SwarmCraft.swarmcraft-vscode-extension.
3. Or install it directly from the command line:

code --install-extension SwarmCraft.swarmcraft-vscode-extension

4. Open the local repository you want to connect to SwarmCraft.

Sign In

SwarmCraft uses the same authenticated account model as the web app.

1. Finish account setup and MFA enrollment in the SwarmCraft web app if you have not done that already.
2. Open the SwarmCraft activity-bar view in VS Code.
3. Run SwarmCraft: Sign In.
4. Complete the MFA challenge if prompted.
5. Run SwarmCraft: Choose Repo and select the local repository folder you want the extension to use.

If you need the full walkthrough, use these guides:

• Install guide: https://swarmcraft.ai/docs/install-and-connect/download-vscode-and-install-swarmcraft
• Sign in and MFA: https://swarmcraft.ai/docs/install-and-connect/sign-in-and-set-up-mfa
• Connect SwarmCraft to your project: https://swarmcraft.ai/docs/install-and-connect/connect-swarmcraft-to-your-project

What You Can Do

• Sign in with your SwarmCraft account using VS Code secret storage for the access token.
• View unlocked project boards in the SwarmCraft activity-bar view.
• Open project boards and tickets in the SwarmCraft web app.
• Choose which local repository folder the extension should use.
• Create linked packet files under .swarmcraft/projects/ for supported tickets.
• Open, reveal, and sync linked packet files from the board.
• Drag tickets within a lane to reorder them and move them one adjacent lane at a time.
• Keep packet notes, checklists, and supported lane changes in sync with SwarmCraft.

Key Commands

• SwarmCraft: Sign In
• SwarmCraft: Sign Out
• SwarmCraft: Refresh
• SwarmCraft: Choose Repo
• SwarmCraft: Create Packet
• SwarmCraft: Open File
• SwarmCraft: Copy Implementation Prompt
• SwarmCraft: Sync Packet
• SwarmCraft: Open Board
• SwarmCraft: Open in Web

Configuration

The extension reads two workspace or user settings:

• swarmcraft.apiBaseUrl: API base URL used for extension requests. Default: https://swarmcraft.ai/api
• swarmcraft.webBaseUrl: browser origin used when commands open SwarmCraft routes. Default: https://swarmcraft.ai

Most users should leave these defaults unchanged.

Support

• Support workspace: https://swarmcraft.ai/login?next=%2fapp%2fsupport
• Product site: https://swarmcraft.ai