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

# Account Setup & Onboarding

Create your Revolte account and get started with either **Interactive Sessions** or **Autopilot Workflows**.

Revolte supports two ways of working. Individual developers can start building immediately in Interactive mode, while engineering teams adopting Autopilot complete a one-time workspace setup before automating delivery.

## Create Your Account

<Tabs>
  <Tab title="New user">
    <Steps>
      <Step title="Sign up for Revolte">
        Select **Sign Up**, then continue with Google, GitHub, or email.
      </Step>

      <Step title="Complete email authentication">
        If you sign up with email, choose either **Email + Password** or **Passwordless Email (OTP)**.
      </Step>

      <Step title="Start your first Interactive chat">
        After signing up for the first time, Revolte opens the **Interactive** chat screen. Enter a prompt to start building immediately, or select **Connect** under **Connect your existing application** to work with an existing repository.

        <Frame>
          <img src="https://mintcdn.com/poddle-54594c3d/N9EC7G0RQ7OPPMvN/image-v2/setup/new-user-post-signup-chat.png?fit=max&auto=format&n=N9EC7G0RQ7OPPMvN&q=85&s=11e8374cee3e12e9b80fc1e2e11d265e" alt="The first-time post-sign-up Interactive chat screen with a prompt composer and an option to connect an existing application." width="2880" height="1356" data-path="image-v2/setup/new-user-post-signup-chat.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Existing user flow">
    **For existing users without an application**

    This flow applies only to returning users who have not created a project or application and have not started an Agentic Chat yet. If you already have an application or previous work, see [Continue Existing Work](/workflows/continue-previous-work).

    <Steps>
      <Step title="Open All Projects">
        Go to [**All Projects**](https://console.revolte.ai/projects). When no Git provider is connected, Revolte displays **Connect Your Repository First**. Select **Custom Token**, then click **Proceed**.

        <Frame>
          <img src="https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/integrations/github-pat-connect-repository.png?fit=max&auto=format&n=rsn4aNVKS_FvNRWy&q=85&s=51a8646f40e8118634c73c3afe9386e2" alt="The All Projects page prompting an existing user to connect GitHub or use a custom token." width="2880" height="1350" data-path="image-v2/integrations/github-pat-connect-repository.png" />
        </Frame>
      </Step>

      <Step title="Connect with the token">
        Return to Revolte, select **GitHub** as the repository provider, and paste the token into the **Personal Access Token** field. Click **Proceed** to connect the repositories covered by the token.

        If you do not have a token yet, follow the [GitHub Personal Access Token setup guide](/integrations/repository/github#personal-access-token).

        <Frame>
          <img src="https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/integrations/github-pat-enter-token.png?fit=max&auto=format&n=rsn4aNVKS_FvNRWy&q=85&s=e6cc44c2c706d2ccfcfdec43628386e3" alt="The Custom Token form with GitHub selected and the Personal Access Token field ready." width="2874" height="1354" data-path="image-v2/integrations/github-pat-enter-token.png" />
        </Frame>
      </Step>

      <Step title="Create an application and select a repository">
        After the token is verified, create or select a project, enter an application name, and choose one of the GitHub repositories available through the token. Then click **Proceed**.

        <div style={{ maxWidth: "360px", margin: "0 auto" }}>
          <Frame>
            <img src="https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/agent/ai-chat/ai-chat-create-app.png?fit=max&auto=format&n=rsn4aNVKS_FvNRWy&q=85&s=e8944baa25fb5f4ecd914743be6973e4" alt="The Create an application form for selecting a project and connecting a repository." width="710" height="1022" data-path="image-v2/agent/ai-chat/ai-chat-create-app.png" />
          </Frame>
        </div>
      </Step>

      <Step title="Start working in AI Task">
        Revolte opens the application on the **AI Task** tab with the connected repository selected. Choose a branch, describe what you want Revolte to deliver, and submit the task.

        <Frame>
          <img src="https://mintcdn.com/poddle-54594c3d/rsn4aNVKS_FvNRWy/image-v2/integrations/github-pat-ai-task.png?fit=max&auto=format&n=rsn4aNVKS_FvNRWy&q=85&s=4d4f1f810f2f532387c54fa727bbaf32" alt="A Revolte application open on the AI Task tab with its GitHub repository connected." width="800" height="358" data-path="image-v2/integrations/github-pat-ai-task.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Choose How You Want to Work

The next step depends on how you plan to use Revolte.

### Interactive Sessions (No Setup Required)

Designed for developers who want to start building immediately.

Create a new session and begin engineering with AI. Connecting GitHub is optional when you start.

If you don't have a repository connected, Revolte provisions a secure session repository so you can work immediately. When you're ready to commit your changes, you'll be prompted to connect GitHub.

**Getting started:**

1. Create a new Interactive session.
2. Start building with a prompt or connect an existing repository.
3. Work in your secure session repository.
4. Connect GitHub when you're ready to commit your changes.

<Note title="Tip">
  Learn more about [Secure Sandboxes](/get-started/quickstart#sandbox).
</Note>

### Autopilot Workspace Setup

Autopilot is designed for engineering teams that want AI to execute work across their delivery lifecycle.

The first time you enable Autopilot, Revolte walks you through a guided workspace setup.

**Setup steps:**

1. Connect your Jira project.
2. Connect your Git provider and repositories.
3. Import your project context.
4. Generate and commit a `revolte.yml` configuration.

**[Follow the Autopilot workspace setup guide →](/workflows/your-first-Autonomous-workflow)**

## Why does Revolte create a `revolte.yml`?

The `revolte.yml` file becomes the blueprint for how Revolte understands and operates on your project.

It stores your project's delivery configuration, engineering preferences, repository settings, environments, and execution rules so future Autopilot tasks can run consistently without requiring repeated setup.

This is typically a one-time setup and evolves alongside your project as your workflows change.