# User docs

If you're trying to get running, start with setup and branch out from there. The rest of this directory is the supporting material: what to edit, where auth lives, what to check when mounts go sideways, and why the stack is built this way in the first place.

## Start here

- Setup paths: [`./setup/README.md`](./setup/README.md)
- Configuration: [`./config.md`](./config.md)
- Authentication: [`./auth.md`](./auth.md)
- Troubleshooting: [`./troubleshooting.md`](./troubleshooting.md)
- Why this stack: [`./why_this_stack.md`](./why_this_stack.md)

## Upgrades

- OpenCode upgrade (1.15.7 → 1.17.4): [`./opencode_1_17_4_upgrade.md`](./opencode_1_17_4_upgrade.md)

## Setup paths

- Fresh install on a new machine: [`./setup/fresh_install.md`](./setup/fresh_install.md)
- Existing repo that already has `.thoughts/config.json`: [`./setup/existing_repo.md`](./setup/existing_repo.md)
- New repo with no Thoughts setup yet: [`./setup/new_repo.md`](./setup/new_repo.md)
- Reboot/remount recovery: [`./setup/reboot.md`](./setup/reboot.md)
