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

# Quickstart

> Get started with repr in 60 seconds

Follow these steps to generate your first stories from your existing git history.

<Steps>
  <Step title="Install repr">
    Install using Homebrew (macOS/Linux) or pipx (Universal).

    ```bash theme={null}
    brew tap repr-app/tap
    brew install repr
    ```

    <Note>See [Installation](/installation) for Windows and other methods.</Note>
  </Step>

  <Step title="Initialize">
    Scan your code directory to find repositories. Repr works best when you point it at a folder containing multiple projects.

    ```bash theme={null}
    repr init ~/code
    ```
  </Step>

  <Step title="Generate Stories">
    Generate summaries for your recent work. By default, this uses your local LLM (if available) or prompts for an API key.

    ```bash theme={null}
    repr generate --local
    ```
  </Step>

  <Step title="View Results">
    See the stories you just created.

    ```bash theme={null}
    repr stories              # List in terminal
    repr dashboard            # Open web UI (recommended)
    ```

    <Tip>Use `rp` as a shorthand for `repr` — e.g., `rp dashboard`, `rp stories`.</Tip>
  </Step>
</Steps>

## Next Steps

Now that you have repr running, explore how to make it part of your workflow.

<CardGroup cols={2}>
  <Card title="Daily Usage" icon="calendar" href="/guides/daily-usage">
    Automate tracking with git hooks.
  </Card>

  <Card title="Configure LLMs" icon="sliders" href="/configuration/llm-setup">
    Set up Ollama or your own API keys.
  </Card>
</CardGroup>