> ## 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.

# Introduction

> Turn your git history into professional narratives

**repr** is a local-first developer tool that reads your git commits and turns them into professional narratives. Think of it as a personal archivist for your work—automatically capturing what you build, so you never have to remember (or recreate) your accomplishments.

<CardGroup cols={3}>
  <Card title="Local-First" icon="lock">
    Your code, diffs, and stories stay on your machine. Zero data leaves without explicit permission.
  </Card>

  <Card title="BYO Model" icon="robot">
    Use local LLMs (Ollama) or your own API keys (OpenAI, Anthropic, etc). Your choice.
  </Card>

  <Card title="Air-Gapped Ready" icon="shield-halved">
    Works in fully offline environments. Defense, healthcare, finance approved.
  </Card>
</CardGroup>

## Real Developers, Real Results

### "I used repr to prep for my Meta interview in 30 minutes"

> I had a final round coming up. They always ask 'tell me about a time you solved a complex problem.' I knew I had good examples buried in my git history, but I couldn't remember specifics.
>
> Ran `repr generate --template interview` and got 8 perfect STAR-format stories with actual metrics from my code. Featured my top 3, exported to markdown, reviewed them the morning of my interview. Nailed every behavioral question.
>
> **— Sarah, Senior Backend Engineer**

[See how to prep for interviews →](/guides/interview-prep)

### "Our sprint demos went from chaos to polished in 5 minutes"

> Every two weeks, our PM would ask 'what did the team ship?' and we'd scramble to remember. Now I just run `repr commits --days 14` on Friday afternoon and export it as our sprint summary.
>
> Added/Changed/Fixed format. Real commit data. No one has to remember what they did. Our stakeholders love it.
>
> **— Marcus, Engineering Manager**

[See team workflows →](/guides/team-workflows)

### "I run repr in a fully air-gapped environment"

> Work in defense. Code can't leave the building. Set up repr with Ollama, locked to local-only mode. Now I can still generate stories for my annual review without ever touching the network.
>
> Privacy audit shows zero external calls. It's the only tool I trust for this.
>
> **— Alex, Security Engineer**

[See privacy-first setup →](/guides/local-only) | [Enterprise deployment →](/guides/enterprise-security)

### "My weekly 1-on-1s with my manager are 10x better"

> I used to show up with vague 'I worked on some bug fixes.' Now I run `repr commits --days 7` before every 1-on-1. I have specific examples of what I shipped, with context.
>
> My manager started using my exports for *her* updates to her boss. Got promoted 6 months later.
>
> **— Jamie, Frontend Developer**

[See weekly reflection →](/guides/weekly-reflection)

## Why use repr?

* **Save 40+ hours/year** — Automated career documentation vs. manual archaeology
* **Interview Prep** — Turn commits into STAR-format stories in 30 minutes (not 4 hours)
* **Performance Reviews** — Generate 6-month impact summary in 5 minutes (not 2 days)
* **Sprint Demos** — Professional changelogs for stakeholders in seconds
* **Privacy & Compliance** — Air-gapped, HIPAA/SOX/ITAR ready, zero telemetry
* **Automated Standups** — Never forget what you did yesterday

[See detailed ROI breakdown →](/guides/why-repr)

## How It Works

1. **Scan your repos** — Point repr at your code directory
2. **Install hooks (optional)** — Auto-capture commits as you work
3. **Generate stories** — LLM reads your commits and creates narratives
4. **Review and curate** — Polish, feature, or hide stories as needed
5. **(Optional) Publish** — Share your profile on repr.dev or keep it private

Everything happens locally by default. You control what (if anything) gets shared.

## Getting Started

<CardGroup cols={2}>
  <Card title="Quickstart" icon="bolt" href="/quickstart">
    Get up and running in less than 60 seconds.
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Install on macOS, Linux, or Windows.
  </Card>

  <Card title="Why repr?" icon="lightbulb" href="/guides/why-repr">
    See ROI calculations and competitive comparisons.
  </Card>

  <Card title="Enterprise" icon="building" href="/guides/enterprise-security">
    Air-gapped deployment and compliance guide.
  </Card>
</CardGroup>

## Popular Guides

<CardGroup cols={2}>
  <Card title="Daily Workflow" icon="calendar" href="/guides/daily-usage">
    Set up hooks and let repr track automatically.
  </Card>

  <Card title="Interview Prep" icon="briefcase" href="/guides/interview-prep">
    Generate STAR-format stories for behavioral interviews.
  </Card>

  <Card title="Privacy First" icon="shield-check" href="/guides/local-only">
    Configure repr for maximum privacy and offline use.
  </Card>

  <Card title="Team Workflows" icon="users" href="/guides/team-workflows">
    Use repr for sprint reviews, retros, and team updates.
  </Card>
</CardGroup>

## Quick Commands

Once installed, these are the commands you'll use most. Use `rp` as shorthand for `repr`.

```bash theme={null}
# First-time setup
repr init ~/code
repr generate --local
repr dashboard                    # Explore stories in web UI

# Daily use (rp = repr)
rp commits --days 3               # Last 3 days (standup)
rp commits --days 7               # Last 7 days (week)
rp generate --local               # Turn commits into stories

# Interview prep
rp generate --template interview
rp story feature <id>             # Pin your best work

# Publishing (optional)
rp login
rp push --all
rp profile link                   # Get your public URL
```

[See the full command reference →](/reference/cheatsheet)