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

# Analyze a repository

> Use Voss to inspect a repository without mutating it.

Use `voss do` in plan mode when you want an architecture summary or risk assessment.

## Run the analysis

```bash theme={"theme":"github-dark"}
cd path/to/repo
voss do "analyze this repo: summarize architecture, entry points, tests, and risks"
```

## Ask for specific outputs

```bash theme={"theme":"github-dark"}
voss do "find the authentication flow and explain which files own it"
```

```bash theme={"theme":"github-dark"}
voss do "summarize this diff and identify missing tests"
```

## Expected behavior

In plan mode, Voss can inspect files and git state but cannot write files or run mutating tools.

## Save useful context

As project cognition lands, repo analysis should update `.voss/architecture.md` and related project memory. Until then, treat the answer as a session artifact.