🔧 Troubleshooting Guide

Common Issues

Can't access application

Problem: "Access denied" error

Solution: - Check you're using the correct port (default: 8000) - macOS: Port 5000 is used by AirPlay - use port 8000 instead - Verify app is running: ps aux | grep python

Stale badge doesn't appear

Problem: Global module changed but no stale badge

Solution: - Override might not have baseline recorded - Edit and save the override again to record baseline - Refresh the page

Changes not showing

Problem: Made changes but don't see them in preview

Solution: - Click "Rebuild Constitution" button - Wait for success message - Then click "Preview"

Can't save override

Problem: "Content cannot be empty" error

Solution: - Ensure textarea has content - Check for whitespace-only content

Git sync errors

Problem: GitHub sync fails

Solution: - Check SKIP_GIT_OPERATIONS environment variable - Verify git credentials - Check repository permissions

Still stuck? See FAQ or Report an Issue.