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

# Quickstart

> First-time setup walkthrough

<Steps>
  <Step title="Launch Mains">
    Open the app. During onboarding, choose the agent runtime you want -- **Claude Code**, **OpenAI Codex**, **GitHub Copilot**, or **Cursor** -- and continue. You land on that agent's workspace, ready to start working. Switch to another runtime from the sidebar anytime.
  </Step>

  <Step title="Import a repository">
    Click **Add Repository** and import a repository — paste a remote URL or select a local path. Mains creates an isolated Git worktree for the workspace automatically.
  </Step>

  <Step title="Run an agent task">
    Open your workspace and type a goal in the agent input -- for example, *"Fix the login bug"*. The agent will read files in the repository, write code, and run commands to accomplish the task.
  </Step>

  <Step title="Review diffs">
    After the agent finishes its run, open the **Changes** tab in the workspace sidebar. You will see a diff view of every file the agent modified, so you can review changes before committing.
  </Step>

  <Step title="Request code review">
    You can ask the agent to explain its changes or provide a code review. Just use agent skill /code-review in the chat input, and the agent will generate a review based on the diffs and the conversation history.
  </Step>

  <Step title="Create a pull request">
    If you're happy with the changes, you can create a pull request directly from the workspace. Use the /create-pr skill in the agent chat input, and Mains will guide you through the PR creation process.
  </Step>
</Steps>