Skip to content

Operator guide

SwarmKit docs

Get a repository into SwarmKit, start sessions, inspect previews, and recover from the common failure states.

Getting started

01

Sign in with GitHub at /auth/github.

02

Connect your Claude account in Settings. Your tokens stay on your account and never touch other users.

03

Connect a repo: Projects → New → paste a GitHub URL. We clone, analyze the stack, and build a container.

04

Create a session: Workspace → New chat → describe what you want done.

05

Watch the agent work. When it is 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, and 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 work.

If you are 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 is not reachable from the proxy.

Troubleshooting

My session output is blank

failed

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, check Settings to confirm your Claude credentials are healthy.

My preview will not load

paused

Open Diagnostics, pick the affected project, and check the preview logs. Common causes are binding to 127.0.0.1, a port collision, or a build step still running.

I hit a plan limit

queued

Upgrade on Billing. Running sessions keep going; only new session creation is blocked until you upgrade or one finishes.

I want to remove my account

stopped

Go to Settings → Delete account and follow the confirmation flow. Deletion is permanent.

FAQ

Plan-level questions live on the Pricing page. If you hit something this page does not cover, email support@swarmkit.app and we will answer it here next.