quickstart.mdx

title	Platform quickstart
description	Create an Autter organization, try a demo repository or connect your own, and get your first review.

Start with a demo repository on GitHub or connect your own GitHub repository or GitLab project. Both paths begin with an Autter account and organization.

Before you begin

You need:

• a GitHub or Google account to sign up for Autter
• for the demo: a GitHub account where you can create a repository and install the Autter GitHub App
• for your own repository: access to a GitHub repository or GitLab project, with permission to install or authorize the integration

You do not need an existing repository to try the demo. The demo setup creates a copy of a project in your GitHub account.

Create your account and organization

Open [app.autter.dev/login](https://app.autter.dev/login) and sign up using **GitHub** or **Google**. If you already have an account, sign in. Click **+ New Organization** or **Create Organization**.

<Frame caption="Start a new organization from the Autter organization menu.">
  <img src="/images/getting-started/create-organization.png" alt="Autter organization menu with the New Organization option" />
</Frame>

Follow the setup form to enter your organization's details, then click **Create Organization**. The name, slug, and description shown below are examples. Use your own details.

<Frame caption="Enter the details for your trial organization.">
  <img src="/images/getting-started/trial-organization.png" alt="Autter form for entering a trial organization name, slug, and description" />
</Frame>

After you create the organization, Autter opens repository selection. Continue with [Try a demo repository](#try-a-demo-repository) or [Connect your own repository](#connect-your-own-repository) below.

<Frame caption="Choose an existing repository or let Autter set up a demo repository.">
  <img src="/images/getting-started/repository-selection.png" alt="Autter workspace setup asking whether to connect an existing repository or create a demo repository" />
</Frame>

If you already have an Autter organization, open it and continue with repository selection.

Try a demo repository

On the repository selection screen, click **I don't have a repo yet — set me up**. Click **Connect GitHub** and complete the account connection. You need this connection for the demo even if you signed up with Google.

<Frame caption="Connect the GitHub account that will own the demo repository.">
  <img src="/images/getting-started/connect-github.png" alt="Autter prompt to connect a GitHub account for the demo repository" />
</Frame>

Return to the Autter dashboard and select a project. The demo choices include **Next.js SaaS**, **Node API**, **Python Worker**, **AI Agent**, and **Infra & Config**.

<Frame caption="Select a demo project in Autter.">
  <img src="/images/getting-started/choose-demo-project.png" alt="Autter demo project choices including Next.js, Node, Python, AI agent, and infrastructure projects" />
</Frame>

Follow the GitHub form to create a copy of the selected project. Choose your GitHub owner and a repository name, then finish creating the repository.

<Frame caption="Create your copy of the demo project on GitHub.">
  <img src="/images/getting-started/create-github-copy.png" alt="GitHub form for creating a repository from the selected Autter demo project" />
</Frame>

Return to the Autter platform and click **Review access on GitHub**. On GitHub, choose **Only select repositories**, select your new demo repository, and approve the installation.

<Frame caption="Review GitHub access and include the new demo repository.">
  <img src="/images/getting-started/install-github-app.png" alt="GitHub App installation screen for granting Autter access to the selected demo repository" />
</Frame>

Return to Autter and select the demo repository you created. Click **Add 1 repository** to connect it to your organization.

<Frame caption="Select the copied demo repository and add it to Autter.">
  <img src="/images/getting-started/select-trial-repository.png" alt="Autter repository selection screen with the copied demo repository selected" />
</Frame>

Open the connected repository in the Autter platform to explore the trial. Continue with [Get your first review](#get-your-first-review) when you are ready to try a pull request.

<Frame caption="Explore your connected demo repository in the Autter workspace.">
  <img src="/images/getting-started/connected-workspace.png" alt="Connected Autter workspace showing repository activity and scan findings" />
</Frame>

Connecting your GitHub account, granting the Autter GitHub App repository access, and adding the repository to Autter are separate steps. Complete all three to finish setup.

Connect your own repository

Use the repository selection screen in your Autter organization to connect an existing repository. You can start here directly or connect your own repository after trying the demo.

On the repository selection screen, click **I have repositories to connect**. Complete the authorization flow for the account or organization that owns your repository. Install the Autter GitHub App or update its access. Choose **Only select repositories** and include the repository you want to try. Return to Autter, select your repository, and click **Add 1 repository** when selecting a single repository.

See [GitHub setup](/guides/github-setup) for connection checks and troubleshooting.

On the repository selection screen, choose the option to connect an existing repository. Start the GitLab connection from Autter and complete the provider authorization flow. Grant access to the project you want Autter to review and complete project selection in Autter.

See [GitLab setup](/guides/gitlab-setup) for connection checks and troubleshooting.

Get your first review

After connecting either a demo repository or your own repository:

1. Open a pull request on the connected GitHub repository, or a merge request on the connected GitLab project.
2. Check the Autter platform for the review status.
3. Look for an Autter review summary, inline findings, or an Autter check in your source control provider.

Evaluate the feedback

Check that the review gives the author enough context to act:

• the affected code or behavior
• why the finding matters
• a proposed fix when Autter can provide one
• the severity or merge impact

If the feedback is too broad or too noisy, adjust the review behavior and add team rules. See Configuration.

Next steps

After you try the first review, you can:

• Add a custom rule to apply your team's standards.
• Connect your own repository if you started with the demo.
• Install the Autter CLI to add line-level AI authorship and coding-agent context. Review Data and privacy before choosing local-only mode or connected mode.

See current pricing for plan details before expanding your rollout.

Troubleshoot the connection

If a repository is missing from selection, confirm that the integration has access to it. For a demo repository, check that you finished creating your copy on GitHub and included that copy in the App's repository access.

If no review appears after connecting a repository:

1. Confirm the repository is included in the integration's access scope.
2. Confirm you selected and added the repository in your Autter organization.
3. Check the Autter platform for a connection or review status.
4. Reopen or update the pull request after fixing access.

{/* TODO: Add the approved platform support path for failed hosted reviews. */}