Skip to main content

​
Agent toggle not visible

  • You don’t have agent-compatible models configured. Contact your Poolside administrator to enable Agent Mode.

​
Agent isn’t accessing the right files

  • Use @ notation to explicitly reference the files or folders you want the Agent to focus on
  • Create or update your AGENTS.md file with better project context

​
Too many approval prompts

  • Configure auto-approval for trusted tools in your .poolside/settings.local.yaml file. For more information, see Tool permissions
  • Start with broader approvals for read-only operations

​
Agent going in wrong direction

  • Press Escape to interrupt
  • Provide more specific instructions or constraints
  • Update your AGENTS.md with clearer guidelines

​
Overlapping inline suggestions

If you notice duplicate or overlapping completions in the editor, like in the example below, it’s likely caused by multiple completion tools being active at the same time. Overlapping completion To avoid conflicts, turn off GitHub Copilot, IntelliCode line completions, or any other tool that offers similar but conflicting capabilities.
GitHub Copilot is now built into VS Code natively and enabled by default. You can manage its behavior globally or per workspace.

​
Turn off GitHub Copilot globally

  1. Open VS Code settings in Code > Settings > Settings (macOS) or File > Preferences > Settings (Windows and Linux). You can also press Command+, (macOS) or Ctrl+, (Windows and Linux).
  2. In the left-side panel of the Settings tab, select Extensions and then select Copilot.
  3. Clear the Inline Suggest: Enable checkbox to disable inline suggestions.
Alternative method using JSON settings
  1. Open the Command Palette by pressing Command+Shift+P (macOS) or Ctrl+Shift+P (Windows and Linux).
  2. Type Preferences: Open Settings (JSON).
  3. Add the following line: 
    "github.copilot.inlineSuggest.enable": false
Changes take effect immediately. You do not need to restart VS Code.

​
Antivirus flags Poolside helper

On Windows, some antivirus tools may incorrectly flag the poolside-helper.exe binary as a threat and block or remove it. This prevents key features from working as expected. To resolve this, add the helper binary to your antivirus allow list: 
%LOCALAPPDATA%\Microsoft\VisualStudio\<version>\Extensions\*\helper\poolside-helper.exe
If the file was already removed, restarting Visual Studio and reinstalling Poolside should restore it automatically.

​
Failed to retrieve login options for this email

If you encounter the error message Failed to retrieve login options for this email after installing the extension, it is likely due to a misconfigured Poolside Base API URI. To resolve this issue, verify the Poolside Base API URI and check whether the Web Assistant is reachable.
  1. Verify the API URI Configuration: Ensure that the Poolside Base API URI is correctly set. For more information, see Connect to your instance.
  2. Test Poolside Web Assistant: Check the availability of your Poolside deployment by accessing the Poolside Web Assistant.
  3. Check Network Connectivity: If both the extension and Poolside Web Assistant are unreachable, consider the following potential issues:
    • Virtual private network (VPN) restrictions
    • Your company’s Poolside backend could be down
    • Network-related problems make your company’s Poolside backend unreachable
If the issue continues after these steps, consider reaching out to your network administrator or support team for further assistance.

​
An error occurred while responding

If you encounter the error message An error occurred while responding in the chat panel, it can have several reasons.

​
Missing agent or model selection

Ensure that you have selected an agent or model for Poolside Assistant to use. Agent mode
  1. In the chat panel, type /agent and press Enter.
  2. Select an agent from the list.
Chat mode
  1. In the chat panel, type /model and press Enter.
  2. Select a model from the list.

​
Network connectivity issues

Network-related problems can cause an error and prevent Poolside Assistant from communicating with the Poolside backend.
  1. Check VPN settings: If you’re using a VPN, it might interfere with the connection. Try disabling the VPN temporarily to see if the issue persists.
  2. Confirm backend availability: Ensure that your Poolside backend is operational and accessible. You can test this by accessing the Poolside Web Assistant.
If the issue continues after these steps, consider reaching out to your network administrator or support team for further assistance.

​
Something went wrong during task migration

This error indicates that Poolside was unable to migrate your tasks to the new format. Your tasks are not lost, but the migration process did not complete successfully.

​
If you’re not currently working on a task and don’t need task history

You can safely ignore this message and continue using Poolside. Tasks you start after the update function correctly. If you need full task history, contact your network administrator or support team.

​
To resume work on an in-progress task

You’ll need to temporarily downgrade the extension to the version you used prior to the update.
Downgrading lets you access your ongoing task, but older tasks may still be unavailable until the migration succeeds. If you require full task history, contact support for help.
  1. Downgrade the extension. See How to downgrade.
  2. Complete your task.
  3. Update the extension to the latest version again.

​
How to downgrade

  1. Open the Extensions view by pressing Command+Shift+X (macOS) or Ctrl+Shift+X (Windows and Linux).
  2. Search for Poolside Assistant.
  3. Click the gear icon next to the extension and select Install Another Version.
  4. Choose the previous version.
  5. Clear the Auto update checkbox to prevent immediate reupgrading.

​
Get additional logs

Collect additional logs to share with Poolside support if the previous steps did not resolve the issue.
  1. Open the View > Output menu or press Command+Shift+U (macOS) or Ctrl+Shift+U (Windows and Linux).
  2. In the Output pane dropdown, select poolside or poolside helper.
  3. Search the logs for any error or warning messages.