# RepoGuide

RepoGuide gives coding agents experience in your repository: what worked, what failed, where to start, and how to validate the result.

Your repository should remember what every agent learns. RepoGuide keeps the useful outcomes from real coding-agent sessions and gives the next agent a short, task-specific briefing before it starts searching.

In our RoastCart benchmark, that cut input tokens by 32% on average (up to 70% on the best task) across 18 real repository tasks. [Read the full benchmark and methodology](https://repoguide.dev/benchmarks.md).

## Benefits

Every finished task gives the next one a head start: more accurate work, fewer wrong edits, less time, and fewer tokens.

And it keeps learning. Agents record feedback at the end of every session, so experience is corrected by the work that just happened instead of freezing at the moment it was written. RepoGuide also follows your git history and detects renames, so moved and deleted files never leave the next agent chasing a path that no longer exists.

### Learn from what succeeded

RepoGuide watches what actually happened: files opened, edits that stuck, tests that caught the bug, feedback, and failed paths. This is evidence from real sessions, not generic memory.

### Start on the right path

Before it searches, the next agent gets likely starting files, repo constraints, known dead ends, and validation paths. The result is less searching, fewer dead ends, and earlier useful edits.

### Compound across the whole team

In Team mode, agent sessions become shared repo experience across developers, machines, tools, and timezones. Your next agent learns from your teammates' experience.

## Find your baseline

[Check your own repo](https://repoguide.dev/check-your-repo.md) with a free private local report showing the average time, tokens, searches, and file reads agents spend before the first useful edit. The report uses your sessions, runs locally, and uploads nothing.

## Install

```sh
curl -fsSL https://repoguide.dev/install.sh | sh
repoguide setup
```

Start offline for free or use RepoGuide Cloud to share experience across a team. RepoGuide does not require uploading your repository.

Coding agent setting this up for a repo: see [agent setup instructions](https://repoguide.dev/agent-setup/prompt.md).

[Read how repo experience works](https://repoguide.dev/repo-experience.md) or [compare plans](https://repoguide.dev/pricing.md).