Troubleshooting

Common Issues

GitHub API Rate Limits

Issue: Failed to fetch latest release: rate limit exceeded Solution:

• Create a GitHub token with public_repo scope
• Use the token with: dotbins sync --github-token YOUR_TOKEN
• Or set the environment variable: GITHUB_TOKEN=YOUR_TOKEN dotbins sync
• Tip: Use GITHUB_TOKEN=$(gh auth token) dotbins sync to use your existing GitHub CLI token

Windows-Specific Issues

Issue: PowerShell execution policy preventing script execution Solution:

• Run PowerShell as administrator
• Execute: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Getting Help

• Enable verbose logging with -v flag: dotbins sync -v
• Check all installed tool versions with: dotbins status
• Join GitHub Discussions for help: https://github.com/basnijholt/dotbins/discussions