# How-To Guides

Task-oriented recipes for common workflows with gptme.
Each guide gives you a copy-pasteable pattern you can adapt immediately.

```{toctree}
:maxdepth: 1

edit-files
code-review
debug-python
automate-task
refactor
```

## File Editing
[Edit files surgically](edit-files.md) — patch, save, and inspect without rewriting whole files.

## Code Review
[Review code changes](code-review.md) — review a diff, a PR, or a single file with context.

## Debug Python
[Debug failing tests](debug-python.md) — reproduce, trace, and fix Python errors step by step.

## Automate Tasks
[Automate shell workflows](automate-task.md) — turn a repeated shell or git procedure into a script.

## Refactor Code
[Refactor across files](refactor.md) — rename, extract, and reshape code across a codebase.

---

For shorter examples and one-liners, see {doc}`../examples`.