Troubleshooting

Agent won't connect

1. Make sure the agent (OpenCode or Claude Code) is installed and on your PATH:

   which opencode   # should print a path
   which claude     # for Claude Code users

2. Try running the agent directly in your terminal to verify it works
3. In Fabriq, go to Settings → Agent and verify the agent is selected
4. Restart Fabriq

Feature creation fails

1. Check that your workspace is properly connected — you should see your project files in the Workspace Browser
2. Verify you have write permissions in the workspace directory
3. Make sure git is installed and your repository is in a clean state:

   git status   # should show no uncommitted changes
   git --version  # should be 2.30+

Confirmation prompts not appearing

1. Check that you haven't disabled confirmations in Settings → Preferences
2. Some actions require confirmation regardless of settings — you'll always see prompts for destructive operations

Build issues (for developers)

If you're building Fabriq from source:

# If electron-rebuild fails, install dependencies without native rebuilds
pnpm install --ignore-scripts

# Ensure you're on Node.js 22.6+
node --version

Fabriq is slow or unresponsive

1. Check how many features you have open — close inactive ones
2. Restart Fabriq
3. Check that you have enough free disk space (at least 500 MB)

Where to get help

• GitHub Issues — report bugs or request features
• Discord — community support and questions
• Email: open an issue on GitHub for the fastest response