Skip to main content
If you run into issues while using Hopsule, check the common scenarios below. If your problem persists, reach out to our Support team.

​
Common Issues

Issue: You get a 410 Gone error when trying to authenticate the CLI or VS Code/Cursor extension.Solution: Device verification codes are short-lived and expire after exactly 10 minutes for security reasons. Simply restart the authentication process (hopsule login) and visit the URL immediately.
Issue: The GitHub repository import seems stuck.Solution: Hopsule processes files in parallel (10 concurrent downloads, 5 chunking operations). A medium repo (1,000 files) takes about 3-4 minutes, while a large repo (10,000 files) can take 30-40 minutes. If it exceeds this time, check your project’s Settings -> Brain to retry the import.
Issue: You’ve accepted a decision, but Cursor is suggesting code that violates it.Solution: Ensure you have generated and loaded the latest Capsule into your IDE. The AI relies on the .contextpack.json file exported by Hopsule to understand your rules.

​
API Errors

Hopsule API always returns a consistent error format. If you are building a custom integration or reporting a bug, please check the error code and provide the requestId to our support team. 
{
  "ok": false,
  "error": "VALIDATION_ERROR",
  "message": "Decision statement cannot be empty",
  "details": {
    "field": "statement",
    "constraint": "required"
  },
  "meta": {
    "requestId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "timestamp": "2026-02-10T12:00:00Z"
  }
}