QUICKSTART

Four steps to your first workspace.

All of it in the app. Then close the laptop.

1
Sign in with GitHub or Google

Join the waitlist with your GitHub or Google account. We email you when your account is ready.

2
Add your agent

Claude Code or Codex on the plan you already have, or Gemini on your API key.

3
Choose where it runs

smedja runs your workspaces on your own compute, so you need one of two: a Docker Sandboxes account (a Docker ID and an access token with sandbox:use), or your own Linux machine with Docker, where you run the launcher. You connect a Docker account once.

4
Connect your code and describe the task

Let workspaces clone your repositories, choose a template for your stack, and say what you want done. The message waits for the workspace, so you don't have to.

Starting a task: choosing a template and Docker Sandboxes
Starting a task: choosing a template and Docker Sandboxes
OR USE YOUR OWN MACHINE

Free, on hardware you already have

Instead of a Docker account in step 3, install the terminal client on a Linux machine that stays on, and run the launcher there. That machine needs Docker. It shows up in the app beside everything else.

$ curl -fsSL https://console.smedja.app/dl/install.sh | sh$ smedja login$ smedja launcher up my-box --docker
OPTIONAL: THE TERMINAL

Workspaces and tasks, as commands

For scripts, and for agents that start their own workspaces. Every command documents itself with --help.

$ smedja workspace create --template node --name first$ smedja conversation start first \ -m "add pagination to the audit log"

Hand off your first task.