SwarmCraft
Install and ConnectGuide

Docs

Sign in and set up MFA

Complete the account and MFA setup flow so the web app and VS Code extension can use the same authenticated session model safely.

Sign in and set up MFA

SwarmCraft keeps docs public, but project and board workflows are authenticated. Before you build anything, complete the sign-in and MFA setup flow.

Start in the web app

Create your account and finish the MFA enrollment flow in the SwarmCraft web app first.

Web app sign-in and MFA guide overview

That matters because the VS Code extension can complete an MFA challenge for enrolled accounts, but it does not handle first-time MFA enrollment.

Then sign in from VS Code

Once MFA is enrolled:

  1. Open the SwarmCraft activity-bar view in VS Code.
  2. Run SwarmCraft: Sign In.
  3. Complete the MFA challenge if prompted.

SwarmCraft extension sign-in with MFA challenge in VS Code

VS Code sign-in steps with MFA challenge flow

The extension stores the access token in VS Code secret storage rather than committing anything into your repository.

If the extension cannot finish sign-in

Go back to the web app and confirm MFA enrollment is complete. Most failed first-time sign-ins happen because the account is trying to challenge before enrollment is finished.

After sign-in is working, continue with Connect SwarmCraft to your project.