Troubleshooting & FAQ

macOS-Specific Issues

Cannot Access Local Folder

Problem: CodeFrog shows an error when trying to access a local project folder.

Solutions:

• Make sure you granted folder access when creating the project
• Try deleting and recreating the project to re-grant access
• Check if the folder still exists at the original location
• For system folders, you may need to grant Full Disk Access (see macOS Setup)

Remote Login Not Working

Problem: CodeFrog cannot connect to localhost even though Remote Login is enabled.

Solutions:

• Open System Settings → General → Sharing → Remote Login
• Make sure Remote Login is toggled ON
• Ensure your user account is in the “Allow access for” list
• Try toggling Remote Login OFF and back ON
• Restart CodeFrog after enabling Remote Login
• Check if SSH is listening: run sudo lsof -i :22 in Terminal

Terminal Not Starting

Problem: The terminal shows an error or doesn’t start.

Solutions:

• Ensure Remote Login is enabled (for local projects)
• Check App Settings to verify terminal configuration
• Try restarting the project
• Check the terminal output for specific error messages

Full Disk Access Issues

Problem: CodeFrog cannot access certain files or folders.

Solutions:

• Open System Settings → Privacy & Security → Full Disk Access
• Add CodeFrog to the list if it’s not there
• Toggle CodeFrog OFF and back ON
• Restart CodeFrog
• If issues persist, remove CodeFrog from the list and re-add it
• See macOS Setup Guide for detailed instructions

Windows-Specific Issues

DLL Errors (OpenGrep)

Problem: CodeFrog shows “missing DLL” errors when running code analysis.

Solutions:

• Close CodeFrog completely
• Delete the binaries cache folder (typically located at C:\Users\YourUsername\AppData\Local\CodeFrog\Cache\Binaries)
• Restart CodeFrog - it will re-extract DLLs automatically
• If issues persist, see Windows Troubleshooting for detailed steps

Long Path Issues

Problem: Files or folders cannot be accessed due to path length limitations.

Solutions:

• Enable long path support in Windows (requires administrator privileges)
• See Windows Setup Guide for detailed instructions
• Move projects to shorter paths if long path support cannot be enabled
• Keep project folder names short

Terminal Not Working

Problem: Terminal doesn’t start or shows errors.

Solutions:

• Ensure Windows Terminal or PowerShell is installed
• Check that OpenSSH Client is installed (Windows Settings → Apps → Optional Features)
• Try restarting CodeFrog
• Check Windows Terminal settings if using Windows Terminal

File Permission Issues

Problem: Cannot access or modify files in project folders.

Solutions:

• Check folder permissions: Right-click folder → Properties → Security tab
• Ensure your user has “Full control” or “Modify” permissions
• Keep projects in user folders (Documents, Desktop) for easier access
• Avoid system-protected folders when possible

Chrome Not Detected

Problem: Web testing features cannot find Chrome.

Solutions:

• Install Chrome to the default location: C:\Program Files\Google\Chrome\Application\chrome.exe
• If Chrome isn’t detected, reinstall to default location
• CodeFrog should automatically find Chrome in standard locations

Connection Issues (All Platforms)

Cannot Connect to Remote Server

Problem: SSH connection fails when trying to connect to a remote server.

Solutions:

• Verify the server hostname/IP address is correct
• Check that the port is correct (default: 22)
• Ensure the server is running and accessible
• Test the connection using Terminal/PowerShell: ssh user@hostname
• Check your network connection
• Verify firewall settings aren’t blocking SSH
• Make sure SSH service is running on the remote server

SSH Authentication Failed

Problem: SSH connection fails with authentication error.

Solutions:

• Verify your username is correct
• If using password: Check that the password is correct
• If using SSH key: Ensure the public key is in the server’s ~/.ssh/authorized_keys
• macOS/Linux: Check SSH key permissions: private key should be 600, public key should be 644
• Windows: Right-click private key → Properties → Security → Remove all users except your account
• Try password authentication as a fallback
• Generate a new SSH key pair if the current one isn’t working

Connection Drops Frequently

Problem: SSH connection disconnects unexpectedly.

Solutions:

• Check your network stability
• Increase SSH keep-alive settings on the server
• Try connecting from a different network
• Contact your server administrator about connection timeouts

GitHub Integration Issues

Cannot Connect GitHub Account

Problem: OAuth authorization fails or doesn’t redirect back to CodeFrog.

Solutions:

• Make sure you’re logged into GitHub in your browser
• Try disconnecting and reconnecting your GitHub account
• Clear your browser cookies and try again
• Check that CodeFrog is allowed in your GitHub OAuth settings
• Visit github.com/settings/applications to manage authorized apps

PR Comments Not Importing

Problem: GitHub PR comments don’t appear in the task manager.

Solutions:

• Make sure the PR has unresolved comments
• Check that you’re viewing the correct repository
• Try refreshing the PR view
• Verify your GitHub connection is still active
• Check if the comments are marked as “nitpick” (hidden by default)

File Browser Issues

Files Not Showing

Problem: File browser is empty or doesn’t show all files.

Solutions:

• Click the refresh button to reload the file list
• Check if you’re in the correct directory
• For local projects: Verify folder access permissions
• For remote projects: Check SSH connection status
• Look for hidden files (files starting with .)

Performance Issues

Slow Performance

Problem: CodeFrog is running slowly or lagging.

Solutions:

• Close unused projects and windows
• Clear terminal history if terminal is slow
• Check system resources (CPU, memory)
• Windows: Use Task Manager to monitor resource usage
• macOS: Use Activity Monitor to check resource usage
• Restart CodeFrog if it’s been running for a long time
• Update to the latest version of CodeFrog

Getting More Help

• Getting Started Guide (macOS) or Getting Started Guide (Windows) - Basic setup instructions
• macOS Setup - Detailed macOS configuration
• Windows Setup - Detailed Windows configuration
• Project Workflows - Understanding local vs. remote workflows
• Tips for New Users - Productivity tips and best practices
• Send Feedback - Contact support