# Documentation
This directory contains the main `stash` documentation.
## Start Here
- [usage.md](usage.md)
Practical usage patterns, stack refs, and everyday workflows.
- [reference.md](reference.md)
Command and option reference for the current CLI.
## Examples And Comparisons
- [examples.md](examples.md)
Longer end-to-end examples.
- [agents.md](agents.md)
Use `stash` as a reusable scratchpad in agent and automation workflows.
- [stash-config-files.md](stash-config-files.md)
Snapshot config files before editing them, compare them later, and restore them if needed.
- [stash-vs-tee.md](stash-vs-tee.md)
How `stash tee` compares to standard `tee`, including return-code behavior.
## Shell Setup and other scripts
Check [scripts/](../scripts/) for instructions and examples on how to integrate
`stash` with various command line workflows and tools.
Completion setup: [zsh.md](zsh.md), [bash.md](bash.md), [fish.md](fish.md)