Factory Bridge Troubleshooting

First, check if Factory Bridge is running on your system:

• Look for the Factory Bridge icon in your system tray or menu bar
• If not visible, try launching Factory Bridge again from your applications folder

Verify you’ve entered the correct pairing code:

• The pairing code should be 6 digits
• Make sure you’re using the most recent code shown in Factory
• Try generating a new pairing code in Factory

If the connection still fails:

• Right-click the Factory Bridge icon in your system tray
• Select “Quit”
• Launch Factory Bridge again
• Enter the pairing code when prompted

Factory Bridge currently supports up to 6 concurrent connections:

• Close some Factory tabs if you have many open
• Try connecting from a new Factory session

Make sure you can see the CLI tools in Factory:

1. Ensure you’re using Droid Mode (select from the model dropdown)
2. Check if the MCP Bridge feature flag is enabled
3. Refresh your Factory session

Ensure your commands are formatted correctly:

1. Verify the syntax of your commands
2. Check that you’re providing all required parameters
3. Make sure paths don’t contain special characters that need escaping

Ensure the specified working directory exists and is accessible:

1. Try using an absolute path instead of a relative path
2. Verify you have permission to access the directory
3. Check for typos in the directory path

When a process is started through Factory Bridge, the PID is returned in the response:

{
  "pid": 12345
}

Look for this information in Factory’s response after starting a process.

Verify if the process is still running:

ps -p 12345

If the process has already terminated, you’ll need to start a new one.

Ensure your system has sufficient resources:

1. Check available memory and disk space
2. Close unnecessary applications
3. Restart your computer to free up resources

Check for error messages:

1. Look for error dialogs when launching Factory Bridge
2. Check system logs for error messages
3. On macOS, check Console.app for related errors
4. On Windows, check Event Viewer for application errors

If all else fails, try reinstalling:

1. Uninstall Factory Bridge completely
2. Download a fresh copy of the installer
3. Install Factory Bridge again
4. Restart your computer after installation

Factory Bridge currently supports up to 6 concurrent connections due to network protocol limitations.

If you’ve reached the limit:

1. Close unused Factory tabs or sessions
2. Wait a few minutes for connections to fully close
3. Try connecting again with a new session

If closing sessions doesn’t help:

1. Restart Factory Bridge completely
2. This will reset all connections
3. Reconnect with your most important session first

First, completely close Factory Bridge:

1. Right-click the Factory Bridge icon in your system tray
2. Select “Quit” or “Exit”
3. Verify the application has fully closed

Clear Factory Bridge configuration files: Delete ~/Library/Application Support/Factory Bridge

Restart Factory Bridge:

1. Launch Factory Bridge from your applications folder
2. You’ll be prompted to enter a new pairing code
3. Enter the pairing code from Factory