🆘 Troubleshooting

Solutions to common issues

❌ 'No API Key Found' Error

  1. 1. Click the HalCode icon in the sidebar
  2. 2. Click Settings (⚙️)
  3. 3. Click 'Set API Key'
  4. 4. Select your provider (Claude or Gemini)
  5. 5. Paste your API key
  6. 6. Try again

❌ 'Invalid API Key' Error

  1. 1. Check that you copied the entire API key
  2. 2. Make sure there are no extra spaces
  3. 3. Verify the key is for the correct provider
  4. 4. Try generating a new API key
  5. 5. Update the key in HalCode settings

❌ Chat Not Responding

  1. 1. Check your internet connection
  2. 2. Verify your API key is valid
  3. 3. Check if you've exceeded API rate limits
  4. 4. Try restarting VS Code
  5. 5. Check the extension logs (View > Output > HalCode)

❌ 'No Codebase Indexed' Error

  1. 1. Click the HalCode icon in the sidebar
  2. 2. Click 'Index Folder'
  3. 3. Select the folder you want to index
  4. 4. Wait for indexing to complete
  5. 5. Try the agentic workflow again

❌ Folder Indexing is Slow

  1. 1. This is normal for large projects
  2. 2. Exclude node_modules and other large folders
  3. 3. Try indexing a smaller folder first
  4. 4. Check your disk speed
  5. 5. Close other applications to free up resources

❌ Conversations Not Saving

  1. 1. Check that you have write permissions in your workspace
  2. 2. Verify your workspace folder is not read-only
  3. 3. Try opening a different workspace
  4. 4. Restart VS Code
  5. 5. Check the extension logs for errors

❌ Extension Not Showing in Sidebar

  1. 1. Click the Extensions icon in the sidebar
  2. 2. Search for 'HalCode'
  3. 3. Click 'Install' if not installed
  4. 4. Click the HalCode icon to open the sidebar
  5. 5. Restart VS Code if needed

❌ Agentic Workflow Stuck

  1. 1. Wait a few seconds for it to complete
  2. 2. Check your internet connection
  3. 3. Click the 'Stop' button if available
  4. 4. Restart VS Code
  5. 5. Try with a smaller folder

Still Having Issues?

If you're still experiencing problems, please contact us:

📧 Email: support@hal-code.online

🐙 GitHub: Report an issue

💡 Tip: Check the extension logs for more details. View > Output > HalCode