Quickstart

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

Install repr

Install using Homebrew (macOS/Linux) or pipx (Universal).

brew tap repr-app/tap
brew install repr

See Installation for Windows and other methods.

Initialize

Scan your code directory to find repositories. Repr works best when you point it at a folder containing multiple projects.

repr init ~/code

Generate Stories

Generate summaries for your recent work. By default, this uses your local LLM (if available) or prompts for an API key.

repr generate --local

View Results

See the stories you just created.

repr stories              # List in terminal
repr dashboard            # Open web UI (recommended)

Use rp as a shorthand for repr — e.g., rp dashboard, rp stories.

Next Steps

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

Automate tracking with git hooks.

Set up Ollama or your own API keys.