Addfox Debugging

Use this skill to diagnose and resolve Addfox build/runtime issues.

When to use

• addfox build or addfox dev fails
• Extension cannot load in browser
• Popup is blank or content script does not inject
• Messaging returns undefined or no response
• Hot reload is not updating as expected

Debug workflow

1. Read terminal output and identify first actionable error.
2. Inspect .addfox/error.md and .addfox/meta.md when present.
3. Verify addfox.config.ts and manifest structure.
4. Validate entry files and resolved output paths.
5. Reproduce issue in browser (chrome://extensions or about:debugging).