> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twill.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> From sign-up to your first verified pull request in a few minutes.

<Steps>
  <Step title="Sign in and create a workspace">
    1. Sign in at [twill.ai/login](https://twill.ai/login) with GitHub or Google.
    2. Name your workspace and pick a URL slug.
  </Step>

  <Step title="Connect GitHub">
    From your workspace home, install the Twill GitHub App and choose which
    repositories it can access. Twill clones every connected repo into one shared
    dev environment, so connect all the repos that make up your stack — the agent
    decides which ones a task touches.
  </Step>

  <Step title="Create your first task">
    Describe a change the way you'd hand it to a teammate. Start small, with a clear before/after, so the first PR is easy to judge:

    ```text theme={"theme":"github-dark"}
    Fix the empty state on the settings page: show a link to create the first workspace.
    ```

    Twill reads the relevant code and asks clarifying questions if the request is ambiguous.

    <Tip>
      Before the first real task, click **Set up dev environment** on the home screen. Twill installs dependencies and starts your dev servers once, and every future task starts from that working state — which is what makes runtime verification possible.
    </Tip>
  </Step>

  <Step title="Review the pull request">
    You get a PR with the change plus whatever proof applies to your repo: test output, logs, screenshots, or a screen recording.

    <Check>
      Nothing merges automatically. You review Twill's work like any other PR.
    </Check>
  </Step>
</Steps>

## Next up

<CardGroup cols={2}>
  <Card title="What to delegate" icon="list-check" href="/first-tasks">
    Good first tasks and example prompts.
  </Card>

  <Card title="Work from your tools" icon="plug" href="/integrations/overview">
    Trigger Twill from GitHub, Slack, Linear, or Notion.
  </Card>

  <Card title="Your dev environment" icon="server" href="/environment">
    What runs inside the sandbox and how to configure it.
  </Card>

  <Card title="Plans & questions" icon="map" href="/planning">
    Get a reviewable plan before any code is written.
  </Card>
</CardGroup>