Common Issues

❓ Common Issues

This guide addresses frequently encountered issues with the Acode AI CLI Assistant Plugin and provides solutions.

🚀 Installation Issues

Plugin Not Appearing in Store

Problem: The AI CLI Assistant plugin doesn't show up in the Acode plugin store.

Solutions:

1. Update Acode to the latest version
2. Clear Acode cache and restart:
   • Settings → Apps → Acode → Clear Cache
3. Check internet connectivity
4. Try manual installation from ZIP file

Installation Fails with Error

Problem: Plugin installation fails with an error message.

Solutions:

1. Verify sufficient storage space on device
2. Check that the ZIP file is not corrupted
3. Restart Acode after installation attempts
4. Try installing from a different network connection

Plugin Installed but Not Working

Problem: The plugin appears installed but doesn't function properly.

Solutions:

1. Ensure the plugin is enabled in Settings → Plugins
2. Restart Acode completely
3. Check that you've completed initial setup
4. Verify API key configuration

🔐 API Key Issues

Invalid API Key

Problem: Error message "Invalid API key" or "Authentication failed".

Solutions:

1. Double-check your API key for typos
2. Verify the key is active on the provider's platform
3. Ensure you're using the right key for the selected provider
4. Regenerate API key if needed

Rate Limit Exceeded

Problem: Error message "Rate limit exceeded" or "Too many requests".

Solutions:

1. Wait a few minutes before making more requests
2. Check your provider's rate limit documentation
3. Upgrade your API plan if available
4. Switch to a different provider temporarily

Connection Failed

Problem: Error message "Connection failed" or "Network error".

Solutions:

1. Check internet connectivity
2. Verify API endpoint URLs are accessible
3. Try switching providers to isolate the issue
4. Check if your network has firewall restrictions

💬 Chat Interface Issues

No Response from AI

Problem: AI doesn't respond to queries.

Solutions:

1. Verify API key is valid and active
2. Check internet connection
3. Try a simple test query
4. Restart the plugin and Acode

Slow Responses

Problem: AI takes a long time to respond.

Solutions:

1. Check provider status pages for service issues
2. Try a different AI provider
3. Reduce context sent to AI by selecting less code
4. Check your network speed

Formatting Problems

Problem: Code blocks or markdown don't render correctly.

Solutions:

1. Update to the latest plugin version
2. Clear plugin cache
3. Check for conflicting CSS in Acode
4. Report rendering issues on GitHub

⚡ Real-Time Analysis Issues

Analysis Not Appearing

Problem: Real-time suggestions don't appear while coding.

Solutions:

1. Ensure real-time analysis is enabled in settings
2. Check that your file type is supported
3. Verify API key is valid
4. Adjust sensitivity settings to "High"

Too Many Suggestions

Problem: Overwhelming number of real-time suggestions.

Solutions:

1. Adjust sensitivity settings to "Low"
2. Increase debounce timing
3. Disable real-time analysis temporarily
4. Use manual triggering instead

False Error Detection

Problem: Plugin flags correct code as erroneous.

Solutions:

1. Adjust debounce timing to reduce false positives
2. Clear cache to get fresh analysis
3. Report persistent false positives to GitHub
4. Use judgment when implementing suggestions

📁 Bulk Operations Issues

File Selection Problems

Problem: Unable to select files for bulk operations.

Solutions:

1. Check file permissions
2. Ensure files are not locked by other processes
3. Restart Acode to refresh file system access
4. Try selecting files in smaller batches

Operation Failures

Problem: Bulk operations fail to complete.

Solutions:

1. Check available storage space
2. Verify file paths are accessible
3. Try operations with fewer files
4. Check API quota if using AI features

Unexpected Results

Problem: Bulk operations produce unexpected results.

Solutions:

1. Always preview operations before confirming
2. Start with small batches to test
3. Backup important files before bulk operations
4. Report issues with AI suggestions on GitHub

🎨 UI/Theme Issues

Theme Not Applying

Problem: Custom themes or Acode themes don't apply correctly.

Solutions:

1. Ensure custom CSS is properly loaded in Acode
2. Check CSS selector specificity
3. Restart Acode to refresh theme application
4. Verify CSS syntax is correct

UI Not Responsive

Problem: Plugin UI feels sluggish or unresponsive.

Solutions:

1. Clear plugin cache
2. Restart Acode app
3. Check device memory usage
4. Disable animations in plugin settings

Display Problems

Problem: UI elements are cut off or misaligned.

Solutions:

1. Rotate device to check different orientations
2. Update Acode to latest version
3. Clear app cache and data
4. Report persistent UI issues on GitHub

🔧 Configuration Issues

Settings Not Saving

Problem: Plugin settings revert after restart.

Solutions:

1. Check Acode storage permissions
2. Verify local storage is functioning
3. Restart Acode completely
4. Report persistent settings issues on GitHub

Provider Switching Problems

Problem: Unable to switch between AI providers.

Solutions:

1. Verify internet connectivity
2. Check that provider API is accessible
3. Restart plugin after changing providers
4. Clear configuration and re-setup if needed

📱 Device Compatibility Issues

Android Version Compatibility

Problem: Plugin doesn't work on older Android versions.

Solutions:

1. Update Android to version 7.0 or higher
2. Update Acode to latest version
3. Try using Ollama for local AI processing
4. Report compatibility issues with device details

Memory Issues

Problem: Plugin causes memory problems or crashes.

Solutions:

1. Reduce conversation history retention
2. Clear plugin cache regularly
3. Disable real-time analysis
4. Close other apps to free memory

🌐 Network Issues

Intermittent Connectivity

Problem: Plugin works inconsistently with network changes.

Solutions:

1. Use stable WiFi connections
2. Check cellular data permissions
3. Enable offline mode features
4. Reduce dependency on real-time features

Proxy/Firewall Problems

Problem: Plugin can't connect through corporate networks.

Solutions:

1. Check network proxy settings
2. Verify API endpoints are not blocked
3. Try using different network connections
4. Contact network administrator for access

📦 Build/Development Issues

Build Failures

Problem: Development builds fail with errors.

Solutions:

1. Ensure Node.js version 16 or higher
2. Run npm install to update dependencies
3. Check build.mjs configuration
4. Clear npm cache and reinstall dependencies

Development Server Issues

Problem: Development server doesn't start or reload properly.

Solutions:

1. Check terminal output for error messages
2. Verify port availability (default 3000)
3. Restart development server
4. Check for file permission issues

🐛 Debugging Tips

Enable Debug Logging

1. Open Acode settings
2. Navigate to Developer Options
3. Enable verbose logging
4. Check logs for error details

Clear Cache

To resolve many issues:

1. Open AI assistant
2. Click menu icon (three dots)
3. Select "Clear Cache"
4. Restart Acode

Reset Configuration

If problems persist:

1. Uninstall and reinstall plugin
2. Clear Acode local storage
3. Reconfigure API keys
4. Test with default settings

📞 Getting Additional Help

If your issue isn't addressed here:

1. Visit our GitHub Issues page
2. Join our Discussions community
3. Check provider-specific documentation
4. Contact plugin maintainers directly

---

🏠 Home | ⬆ Back to Top | 🔐 Security Implementation