Diagnostic Guide

Not sure what's wrong? Use this step-by-step diagnostic to identify and resolve issues.

Quick Health Check

Start with these 5 quick checks:

✅ Check 1: Is the App Running?

Question: Can you open FabriXWork and see the dashboard?

• Yes → Go to Check 2
• No → See Installation Issues

✅ Check 2: Are You Logged In?

Question: Do you see your name and agent list in the sidebar?

• Yes → Go to Check 3
• No → See Login Issues

✅ Check 3: Can You Access an Agent?

Question: Can you click on an agent and open a chat?

• Yes → Go to Check 4
• No → See Agent Output Issues (may be session issue)

✅ Check 4: Is the Agent Responding?

Question: When you send a message, does the agent respond (even if incorrectly)?

• Yes → Go to Check 5
• No (frozen/timeout) → See Performance Issues

✅ Check 5: Is the Output Correct?

Question: Is the agent's response helpful and accurate?

• Yes → Issue may be resolved! If something else is wrong, continue below.
• No → See Agent Output Issues

Symptom Checker

Find your symptom below to identify the likely issue:

"The app won't open at all"

→ Installation Issues

"I see an error message on startup"

→ Installation Issues

"It says my password is wrong but I'm sure it's correct"

→ Login Issues

"I keep getting logged out"

→ Login Issues

"The agent doesn't respond when I send a message"

→ Performance Issues or Agent Output Issues

"The agent's response is wrong or unhelpful"

→ Agent Output Issues

"The file wasn't created/modified correctly"

→ Agent Output Issues

"The app is very slow"

→ Performance Issues

"My computer fans are loud when using FabriXWork"

→ Performance Issues

"I can't access my files/folders"

→ Installation Issues (folder permissions)

"Something unexpected is happening"

→ Continue to Detailed Diagnostics below

Detailed Diagnostics

If the quick checks didn't identify the issue, work through these steps:

Step 1: Identify the Problem Area

Which category best describes your issue?

• [ ] Installation/Launch - App won't start, crashes on open
• [ ] Authentication - Login problems, access denied
• [ ] Agent Interaction - Can't chat, agent doesn't respond
• [ ] Output Quality - Agent responses are wrong or unhelpful
• [ ] File Operations - Files not created, modified, or saved correctly
• [ ] Performance - Slow, laggy, high resource usage
• [ ] Other - Something else

Step 2: Gather Information

Before seeking help, collect this information:

1. What were you trying to do?

   • Be specific: "I was trying to add an agent" vs. "It doesn't work"

2. What error messages did you see?

   • Copy the exact text
   • Take a screenshot if possible

3. When did it start happening?

   • First time using FabriXWork?
   • After an update?
   • Suddenly, after working fine before?

4. Can you reproduce it?

   • Does it happen every time?
   • Only with certain agents?
   • Only with certain files?

5. What have you tried already?

   • List the troubleshooting steps you've attempted

Step 3: Try Universal Fixes

These fixes work for many issues:

Fix 1: Restart the Application

1. Close FabriXWork completely (Cmd+Q on Mac, Alt+F4 on Windows)
2. Wait 10 seconds
3. Reopen FabriXWork
4. Try your task again

Fix 2: Start a New Agent Session

1. Close the current chat
2. Click on the agent again in the sidebar
3. Start fresh with a new message

Fix 3: Reconnect Your Folder

1. In the chat interface, click "Change" on the folder panel
2. Select your folder again
3. Confirm the folder is accessible

Fix 4: Check for Updates

1. Go to Settings (gear icon)
2. Look for "Check for Updates" or version info
3. If update available, follow prompts to install

Fix 5: Restart Your Computer

Sometimes a full system restart resolves underlying issues.

Step 4: Document What You Found

Create a brief summary:

Issue Summary:
- What I was trying to do: [description]
- What happened instead: [description]
- Error message (if any): [exact text]
- When it started: [date/time]
- Can I reproduce it: [yes/no, how]
- What I've tried: [list of steps]
- System: [macOS/Windows + version]

Decision Tree

Start
  │
  ▼
Can you open FabriXWork?
  ├─ No → [Installation Issues](installation-issues.md)
  │
  ▼ Yes
Can you log in?
  ├─ No → [Login Issues](login-issues.md)
  │
  ▼ Yes
Can you open an agent chat?
  ├─ No → Contact administrator (may be account issue)
  │
  ▼ Yes
Does the agent respond?
  ├─ No → [Performance Issues](performance-issues.md)
  │
  ▼ Yes
Is the output correct?
  ├─ No → [Agent Output Issues](agent-output-issues.md)
  │
  ▼ Yes
Issue may be resolved! If not, see [Other Issues](#other-issues) below.

Other Issues

If your issue doesn't fit the categories above:

Security or Policy Questions

→ Technical FAQ

How-To Questions

→ Getting Started or Use Cases

Feature Requests or Feedback

→ Contact fabriXWork Support Team

Suspected Bug

→ See How to Get Help in the main troubleshooting index

When to Contact Support

Contact your administrator if:

• ✅ You've tried the relevant troubleshooting steps
• ✅ The issue persists after restarting
• ✅ You've documented the issue (see Step 2 above)
• ✅ The issue blocks your work

Include in your message:

• Summary from Step 4 above
• Screenshots (if applicable)
• Urgency/priority (is work blocked?)

Quick Reference: Where to Go

Found your issue? → Go to the relevant section above
Still stuck? → See How to Get Help