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

# Make a scoped edit

> Use voss edit to make bounded file changes with test mirrors.

Use `voss edit` when you know the target area.

## Start with a target

```bash theme={"theme":"github-dark"}
voss edit src/auth/session.py
```

Tell Voss the change:

```text theme={"theme":"github-dark"}
Add validation for expired sessions and update the focused tests.
```

## Review scope

Voss may write the target and existing nearby test mirrors. If it needs another file, it must ask.

## Validate

Run focused checks:

```bash theme={"theme":"github-dark"}
pytest -q tests/auth/test_session.py
```

Then run broader checks if the change touches shared behavior:

```bash theme={"theme":"github-dark"}
pytest -q
```

## Resume if needed

```bash theme={"theme":"github-dark"}
voss sessions
voss resume <session-id>
```