~/sursakit

// docs

Quickstart

From cold start to shipping a change in a few minutes.

1. Sign in

Open the app and sign in with email or an OAuth provider — Google or GitHub. You'll land on the dashboard with your default organization selected.

2. Create a workspace

Click New workspace. Pick a name and add one or more services:

  • Import from Git — GitHub, GitLab, or Bitbucket (OAuth-connected).
  • Docker Hub image — point at a public or authenticated image.
  • Upload — drop a zip or folder.
  • Empty — start from scratch.
  • Database — pick a managed database template.

Each service comes up with sensible defaults: base image, env vars, and runtime limits.

3. Open a session

Every workspace ships with a default session called main. Open it — your services boot inside isolated container runtimes attached to the session.

4. Edit and run

  • The file explorer shows every service. Open a file; the editor connects to a language server over WebSocket.
  • Click Run on a service to start it. Logs stream in the bottom panel.
  • The terminal panel opens a real PTY into any running service.

5. Commit and ship

  • Open the Version Control panel — diff, stage, commit. Sursakit can generate a commit message from the diff.
  • Open a pull request against your Git provider directly from the workbench.
  • When Codex finishes a task, its work shows up the same way: a PR scoped to the agent's session, ready for review.