> For the complete documentation index, see [llms.txt](https://copilot-docs.bugbase.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://copilot-docs.bugbase.ai/enterprise/how-to-trigger-an-external-scan/manual-crawler.md).

# Manual Crawler

Explore an external target interactively in Debug Mode.

Manual Crawler opens a proxied browser so an operator can capture important pages and user flows that automated discovery missed.

{% hint style="warning" %}
Manual Crawler is a Debug Mode capability. It is hidden or disabled on deployments and workspaces where Debug Mode is not enabled.
{% endhint %}

## Start a Crawler

1. Open **External Assessment -> Run Assessment**.
2. Choose an intent that includes the target and continue to **Scope**.
3. Select and configure the asset.
4. Under **Explore manually**, choose **Crawl as**:
   * **Unauthenticated** starts without a login state;
   * a named browser session reuses that recorded account.
5. Select **Open logged-out crawler** or **Open session crawler**.

The selected crawl context is independent of the assessment's authentication coverage. Opening a crawler does not add another context to the run.

## Use the Proxied Browser

Wait for the status indicator to show that the browser is ready before each action.

| Control             | Use                                                                                                                                          |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **Start Recording** | Begin a trajectory from the current page.                                                                                                    |
| **Refresh**         | Rescan the current DOM and reapply actionable-element highlights after dynamic content changes. It does not perform a normal browser reload. |
| **Reset**           | Discard the in-progress trajectory and return to its starting point.                                                                         |
| **Done**            | Save captured trajectories and end the crawler.                                                                                              |
| **Abort**           | Stop without saving the current in-progress trajectory.                                                                                      |

Use **Refresh** when a click, form step, or single-page application navigation reveals new controls that are not highlighted. Normal page navigation automatically refreshes highlights when it completes.

Keep the proxied browser open until the UI confirms that the trajectory was saved. Cancel the crawler from Pentest Copilot if the browser becomes unusable.