# Troubleshooting

## Overview
This guide helps users and developers diagnose and resolve common issues in oosh/once.sh, including script errors, test failures, and shell integration problems.

## Common Issues
- Installation problems
- Environment variable conflicts
- Permission and sourcing errors

## Debugging Tips
- Using log levels and log devices
- Enabling shell tracing and debug output
- Interpreting error messages and stack traces

## Interpreting Test Failures
- Understanding test suite output
- Debugging failed test cases
- Using expect and expect.error for diagnosis

## Shell Error Handling
- Handling non-zero exit codes
- Dealing with missing dependencies or commands

## See Also
- [test-suite.md](test-suite.md)
- [advanced-usage.md](advanced-usage.md)
- [configuration.md](configuration.md)