Get started
Quickstart
Sign in, connect a coding agent and start your first thread.
Statefold runs your coding agent in an isolated cloud workspace and keeps the conversation, files, changes, terminal and preview together in the browser, on a desktop or a phone. Model access comes from your own subscription or API key.
1. Sign in
Sign in with GitHub, Google or an emailed six-digit code. Signing in with GitHub, or linking it later, gives a new account a one-time $3 starter credit, about ten hours on the default machine.
The sidebar shows a setup checklist until you finish it: set up billing, connect a coding agent, connect GitHub and start your first thread. Nothing on it blocks you, and Hide setup dismisses it.
2. Connect a coding agent
Open Settings → Agent connections and connect Codex, Claude Code, OpenCode, Pi or Gemini CLI with your own account. Your credential stays on Statefold's side and never enters the workspace. Claude subscriptions connect from your computer with the CLI. See Connect a coding agent.
3. Add credits
Credits pay for the machine while it runs, separately from your provider's model charges. Choose a plan or top up in Settings → Billing. See Credits and machines.
4. Connect GitHub (optional)
Install the GitHub App on the repositories agents may work on. You can start without a repository and link one to a thread later. See Connect GitHub.
5. Start a thread
Choose a repository or a new project, pick a connection and model, describe the change and send. The agent starts within a few seconds and works with full access: it runs commands and edits files without waiting for approval.
Or hand off your current checkout from a terminal:
statefold login
statefold task new "Fix the flaky checkout test"Read the thread's status
A thread's status comes from what is actually running and linked, never from the agent declaring itself finished:
| Status | Meaning |
|---|---|
| Working | A turn is running, or messages are queued for it. |
| Needs you | The agent asked a question only you can answer. |
| Ready to review | There are unshipped changes, an open pull request or active subscriptions. |
| Done | The pull request merged, nothing is pending, or you archived the thread. |
| Failed | The agent errored, or the workspace could not stop or save. |
| Limited | A provider usage limit, no credits, or a suspended account. |
When a provider limit stops a thread, it shows when the limit resets, with Resume now and Resume at reset.
Ship the result
Ship asks the agent to follow the project's shipping behavior: push a branch and open a pull request (the default), ship to the base branch, or your own instructions. It is a request to the agent, not an automatic merge.
Next
- Notifications: hear back when a thread finishes or needs you.
- Project environments: new threads start with dependencies installed.
- Schedules and subscriptions: wake a thread on a timer, a CI result or a review.