Help & Troubleshooting

Having issues with FabriXWork? This section helps you diagnose and resolve common problems quickly.

🚨 Quick Diagnostic Guide

What's going wrong?

📖 Troubleshooting Guides

🔍 Diagnostic Guide

Not sure where to start? Use our step-by-step diagnostic flowchart to identify the issue.

Includes:

• Quick health check checklist
• Common symptom checker
• When to contact support

Best for: When you're not sure what's causing the problem

❓ Technical FAQ

Common technical questions from the pilot team on security, permissions, and enterprise deployment.

Covers:

• Preventing auto-installation
• Safeguarding confidential data
• Controlling application updates
• Uninstalling third-party programs
• Distributing trained agents

Best for: IT admins and technical decision makers

📥 Installation Issues

Problems installing or launching FabriXWork?

Covers:

• macOS security warnings
• Windows dependency issues
• App won't launch
• Folder access problems

Best for: First-time setup issues or after updates

🔐 Login Issues

Can't log in or keep getting logged out?

Covers:

• Invalid credentials
• Session timeout
• Account access errors
• Network connectivity

Best for: Authentication and session problems

🤖 Agent Output Issues

Agent responses aren't what you expected?

Covers:

• Vague or generic outputs
• Incorrect information
• Format problems
• File not created/modified

Best for: When agents aren't delivering expected results

🐌 Performance Issues

App is slow or freezing?

Covers:

• Slow response times
• High memory usage
• Large file handling
• Optimization tips

Best for: Speed and responsiveness problems

⚡ Quick Fixes: Try These First

Before diving into detailed troubleshooting, try these 5 quick fixes:

1️⃣ Refresh the Application

Close FabriXWork completely → Wait 10 seconds → Reopen

2️⃣ Check Your Internet Connection

Verify internet access → Try loading a website → Switch WiFi/wired if needed

3️⃣ Restart the Agent Session

Close current chat → Click agent in sidebar → Start new session

4️⃣ Check Folder Permissions

Verify folder exists → Confirm read/write access → Reconnect folder

5️⃣ Clear Cache

Settings → Clear Cache/Reset → Restart application

❓ Common Questions

📋 How to Get Help

If you can't resolve the issue using this guide:

Option 1: Check Documentation

• Getting Started — Review setup steps
• Technical FAQ — Check policies
• Use Cases — See if it's a usage question
• Best Practices — Learn effective workflows

Option 2: Contact Support

Reach out to FabriXWork Support Team with:

• Description of the issue
• Steps you've already tried
• Screenshots (if applicable)
• Your operating system and version

Option 3: Document the Issue

For tracking purposes, note:

• Date and time of issue
• What you were trying to do
• Error messages (exact text)
• Agent you were working with

🐛 Reporting Bugs

If you believe you've found a bug, include these details in your report:

1. What you expected to happen
2. What actually happened
3. Steps to reproduce (be specific)
4. Screenshots or screen recording (if possible)
5. Your system info:
   • Operating System (macOS/Windows + version)
   • FabriXWork version (if known)
   • Agent you were using

Issue: Agent output file not saved to correct folder

Expected: File should be saved to /Documents/Output folder
Actual: File was saved to Downloads folder

Steps to reproduce:
1. Added agent "Alex - Business Analyst"
2. Asked to create a report and save to Output folder
3. Agent confirmed file was saved
4. File not found in Output folder, but in Downloads

System: macOS 14.2, FabriXWork v1.0 (assumed)

💡 Feedback

Help us improve this guide! If you:

• Found a solution not documented here
• Think a section is unclear
• Have suggestions for improvement

Share your feedback with the pilot program team.

Ready to diagnose? → Start with Diagnostic Guide

Need quick answers? → Check Common Questions above