Troubleshooting

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   🛡️  **Mac Hacker Toolkit**                              v1.0.3 • 2026-04-21 │
│                                                                              │
│   🔗 [Home](Home)  📖 [Getting Started](Getting-Started)  🔧 [Tools](Tool-Reference) │
│   📡 [Architecture](Architecture)  🔐 [Security](Security)  🤝 [Contributing](Contributing) │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

---

Troubleshooting

Common Issues

App Won't Launch

Symptoms: App crashes or shows error on startup

Solutions:

1. Check macOS version (requires 14.0+)
2. Grant necessary permissions
3. Rebuild from source:

   xcodegen generate
   xcodebuild -scheme MacHackerToolkit -configuration Release build

Wi-Fi Scanner Not Working

Symptoms: No networks found or scan fails

Solutions:

1. Grant Wi-Fi permission in System Settings
2. Ensure no other app is using Wi-Fi
3. Check network interface is active

Bluetooth Scanner Crash

Symptoms: App crashes when opening Bluetooth scanner

Solution: Update to v1.0.3+ (fixed EnvironmentObject issue)

AI Features Not Working

Symptoms: AI assistant returns errors

Solutions:

1. Ensure Ollama is installed: brew install ollama
2. Start Ollama service: ollama serve
3. Pull models: ollama pull mistral

Tools Not Found

Symptoms: "Command not found" errors

Solutions:

1. Run install script: ./scripts/install.sh
2. Add to PATH:

   echo 'export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"' >> ~/.zshrc

Reset App

To reset all settings:

rm -rf ~/Library/Application\ Support/MacHackerToolkit
rm ~/Library/Preferences/com.worldhackerlabs.machackertoolkit.plist

Get Help

• GitHub Issues
• GitHub Discussions

---

🍎 Brand & Resources

Resource	Link
📖 Documentation	Wiki Home
📦 Releases	GitHub Releases
🐛 Issues	GitHub Issues
💬 Discussions	GitHub Discussions
📜 License	MIT License

---

🔐 Mac Hacker Toolkit — Built with ❤️ for the security community