Troubleshooting

Solution

Use sudo to install the package (on Linux/macOS) or run the command prompt as administrator (on Windows):

Alternatively, you can fix npm permissions to allow global installations without sudo:

Solution

Upgrade your Node.js installation to version 14 or higher:

• • Download and install the latest LTS version from nodejs.org
• • Or use a version manager like nvm (for Linux/macOS) or nvm-windows (for Windows)

Solutions

• 1.Run the installer as administrator (Windows) or with sudo (Linux).
• 2.Temporarily disable your antivirus software during installation.
• 3.Download the installer directly from the official website instead of using the CLI.
• 4.If you're on macOS, you might need to allow the application in System Preferences → Security & Privacy.

Solutions

• 1.Verify that you're using the correct API key. You can find your API key in the RefineAI dashboard.
• 2.Ensure that you're not including any whitespace or quotes around the API key.
• 3.Generate a new API key if you suspect your current one is compromised or invalid.
• 4.Check that your API key has the necessary permissions for the operation you're trying to perform.

Solutions

• 1.Set your API key using the CLI config command:

• 2.Alternatively, you can provide the API key as a command-line argument:

• 3.Or set it as an environment variable:

Solutions

• 1.Analyze specific directories or files instead of the entire repository:

• 2.Use a more specific include/exclude pattern in your configuration file:

# .refineai.yml
analysis:
  include:
    - "src/components/**/*.js"
    - "src/utils/**/*.js"
  exclude:
    - "**/*.test.js"
    - "**/*.spec.js"
    - "node_modules/**"
    - "dist/**"

• 3.For very large repositories, consider upgrading to a higher tier plan with increased timeout limits.

Solutions

• 1.Commit or stash your local changes before running the optimization:

• 2.Re-run the analysis before optimization to ensure it's based on the current state of your codebase:

• 3.Use the --force flag to apply optimizations even if there are conflicts (use with caution):

Solutions

• 1.Check the list of supported languages and frameworks in the FAQ.
• 2.Focus on analyzing supported files in your project:

• 3.Contact support to request support for additional languages or frameworks.

Solutions

• 1.Check that the RefineAI GitHub App has the necessary permissions for your repository. Go to your repository settings → GitHub Apps and review the permissions.
• 2.If you're using a GitHub token in CI/CD, ensure it has the repo scope.
• 3.For organization repositories, ensure that the RefineAI GitHub App is installed at the organization level or has access to the specific repository.

Solutions

• 1.Ensure that the configuration file exists in your repository and is correctly named.
• 2.Check that the CI/CD pipeline has access to the necessary environment variables, especially the API key.
• 3.Verify that the CI/CD configuration is correct and follows the examples in the CI/CD integration documentation.
• 4.If you're using a custom configuration file path, make sure it's correctly specified in the CI/CD configuration.

Solutions

• 1.Check your internet connection and ensure that your network allows connections to the RefineAI API.
• 2.Verify that your API key is correctly configured in the IDE plugin settings.
• 3.If you're behind a corporate firewall or proxy, configure the IDE plugin to use the proxy settings.
• 4.Try restarting your IDE or reinstalling the plugin if the issue persists.