SwarmKit Docs

A quick tour of how to get running, plus fixes for the handful of things that tend to trip people up.

Getting started

  1. Sign in with GitHub at /auth/github.
  2. Connect your Claude account in Settings. Your tokens stay on your account and never touch other users.
  3. Connect a repo: Projects → New → paste a GitHub URL. We clone, analyze the stack, and build a container.
  4. Create a session: Dashboard → New Session → describe what you want done.
  5. Watch the agent work. When it's done, open the live preview to test.

Connecting a repo

SwarmKit works with any Git repo you have access to. For private repos we use your GitHub OAuth token, so anything you can see on GitHub you can connect here.

After cloning, a setup agent detects the tech stack and installs dependencies. This is usually 60–120 seconds for Node, Ruby, or Python projects, longer the first time we pull a base image.

Live previews

Each session gets a unique *.swarmkit.app URL pointing at the dev server running inside your container. The proxy handles HMR WebSockets automatically, so Vite, webpack-dev-server, and Rails hot-reload all just work.

If you're wiring up a new framework, make sure the dev server binds to 0.0.0.0 and not 127.0.0.1—the container-internal loopback isn't reachable from the proxy.

Troubleshooting

My terminal is blank

Usually a token problem. If you see a banner asking you to reconnect your Claude account, click it and reconnect. Otherwise try Restart Session from the session page. If the same session comes back blank twice in a row, check Settings to confirm your Claude credentials are healthy.

My preview won't load

Open Diagnostics, pick the affected project, and check the preview logs. Common causes:

  • Dev server listening on 127.0.0.1 instead of 0.0.0.0—rebind in your app's config.
  • Port collision inside the container—restart the session.
  • Build step still running—give the setup agent a minute on fresh projects.

I hit a plan limit

Upgrade on Billing. Any sessions already running keep going; only new session creation is blocked until you upgrade or one of the running sessions finishes.

I want to remove my account

Go to Settings → Delete account and follow the confirmation flow. Deletion is permanent: projects, sessions, and stored tokens are removed and can't be restored.

FAQ

Plan-level questions (what's free, what's in Maker, how billing works) live on the Pricing page. If you hit something this page doesn't cover, email support@swarmkit.app and we'll answer it here next.