Troubleshooting
Troubleshoot login, connection, task execution, and file transfer issues based on error symptoms.
What to Do When Login Fails, Session Expires, or You Experience Repeated Redirects
First identify the type of error, then initiate a complete login again from the current page or desktop.
What to Do If the Computer Disconnects or the Agent Cannot Connect?
Restore the desktop or CLI separately, then check the original task, selected environment, and execution errors.
What to Do If the Browser Shows Login Success but Does Not Return to the Desktop App?
Use the redirect link on the current authentication completion page; if it fails, restart from the desktop app.
Why Does the Desktop Prompt Require an Update Before Logging In?
When the old version lacks the current login capability, the application must be updated; modifying the return URL alone cannot restore functionality.
What to Do If the Installation Package Fails to Download, Won't Open, or the Wrong Version Is Selected
First verify the official source and target architecture, then distinguish between download, system installation, and login issues.
What to Do If Automatic Update Fails or the Old Version Persists After Restart?
Distinguish between the check, download, install, and restart phases; save current tasks before resuming.
Why does Agent still show the computer as unavailable even though the desktop application is open or logged in?
Login, connection readiness, and task permissions are independent conditions. First, restore the currently selected computer.
What to do if clicking 'Copy Command' fails or pasting results in placeholders?
Use the copy button to generate the complete command, distinguishing between preparation failure and clipboard failure.
What to Do If the Terminal Says It Can't Find node, npx, or hackcat-local?
First fix the runtime environment of the target terminal, then start using the standard command in the settings.
How to Recover When Local Agent Reports Token Invalid or Denied?
Reacquire the current account command, reset credentials if necessary, and restore affected connections.
What to Do If Local Agent Prompts Missing or Invalid Service Address?
Recopy the complete command generated by the current settings; do not splice backend parameters from old articles.
Website Opens but Local Agent Stuck Connecting to Relay or Times Out - What to Do?
Distinguish between webpage access and persistent command connections; check the target computer's network and proxy paths.
Terminal Indicates Connection Limit Reached, Should I Reset the Token?
This type of error indicates that the command connection capacity is limited. Stop repeatedly starting the client and try again later as prompted.
Why Does the Server Indicate Multiple No Responses from Local Agent and Stop Connecting?
The presence of connection records does not mean commands still respond; first restart the client and verify the original task.
What to Do If the Desktop Keeps Reconnecting After Computer Sleep or Network Switch?
First restore the target machine and network, then trigger desktop connection recovery and check the original task.
Why does it still indicate the selected computer is unavailable even though there is an online computer?
The available connection differs from the currently selected one; especially when restoring old tasks, verify the target machine carefully.
What to Do If a Project Prompt Requires Connecting to Desktop or Bound Directory Is Unusable?
Directory projects require a suitable desktop environment; first verify the connection and the actual path.
Agent Connected but Running Tool Shows 'command not found' - What to Do?
Check the tool installation, path, and execution user on the target host; do not mistake tool errors for connection errors.
What to Do If the Same Command Runs Locally but Shows Syntax Errors in Agent?
First confirm the shell actually used by Agent, then correct parameters, quoting, and paths.
Permission Denied for Local Files or Command Prompts: How to Handle It?
First identify system permission issues and desktop file connection errors to avoid unauthorized privilege escalation or redundant writes.
Local Agent Can Run Commands, Why Is Browser Automation Still Unavailable?
Local browser capabilities depend on actual installation; a successful connection does not mean the browser tools are ready.
Will input drafts be lost when the page shows offline, and how to recover sending?
Keep the text draft on the current device, reconnect after network recovery, then confirm the task status.
How to Determine if a Task Is Still Running When Replies or the Computer Panel Stop Updating?
First restore real-time display and check the original task to avoid mistaking output interruption for task completion.
What to Do If the Approval Card Keeps Reconnecting or Does Not Respond After Allowing an Operation?
First restore the approval session, then submit a clear decision again without fully switching to bypass connection errors.
After clicking stop, the task still outputs—how to confirm if stopping was successful?
Stop requests may fail or encounter runtime switching; do not assume button changes mean all operations have been revoked.
Attachment Upload Failed: When Can I Retry Directly?
Choose to retry, re-add, or first resolve permission and file issues based on the failure type.
Does Switching Agents Always Solve Upload Errors for Oversized Files or Images?
Distinguish between Ask, Agent, and image processing limits, and reduce file size according to the actual task.
Why do only some files appear when adding too many attachments at once?
The number of attachments is calculated based on the current mode and already added files, verified item by item, and processed in batches.
What to Do If a Locally Selected Desktop File Cannot Be Found or Fails to Load Later
Check the source file location, the executing machine, and connection status, then re-add the correct file.
What to Do If Agent Says the File Was Generated but Cannot Preview or Download?
Distinguish between the three stages of generating, providing the file, and opening the link, and only recover the failed parts.