> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotool.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunt

> Turn threat intelligence into tracked threats, exposure assessments, and Hunt alerts

Hunt helps your team turn incoming threat intelligence into a durable workflow. Cotool ingests intel, decides whether it is relevant to your environment, checks for exposure or compromise signals, tracks coverage gaps, and creates alerts when something needs attention.

## Main Hunt surfaces

Hunt has four main screens in the product:

<CardGroup cols={2}>
  <Card title="Overview" icon="chart-line">
    A summary of recent intel, assessed threats, exposure alerts, rule
    proposals, and observability gaps.
  </Card>

  <Card title="Threats" icon="shield-halved">
    The durable catalog of tracked threats, with grouped, table, and board
    views.
  </Card>

  <Card title="Intel Feed" icon="newspaper">
    The raw stream of ingested threat intelligence items.
  </Card>

  <Card title="Intel Sources" icon="satellite-dish">
    Where you manage built-in sources plus your own RSS, MISP, and TAXII
    feeds.
  </Card>
</CardGroup>

## How Hunt works

At a high level, Hunt follows this flow:

<Steps>
  <Step title="Ingest intel">
    Cotool pulls threat intelligence from built-in sources, custom intel
    sources, or the <code>/hunt-intel</code> chat command.
  </Step>

  <Step title="Create or update a threat">
    Related intel is grouped into a durable threat record so the same threat
    can be tracked across assessments, alerts, and follow-up work.
  </Step>

  <Step title="Assess relevance and exposure">
    Cotool decides whether the threat applies to your environment and, when
    it does, runs an exposure assessment.
  </Step>

  <Step title="Capture outcomes">
    Hunt records findings such as compromise signals, exposure, no exposure,
    existing detection coverage, or telemetry gaps.
  </Step>

  <Step title="Open follow-up work">
    If Hunt finds something actionable, it creates a Hunt alert in
    <a href="/alerts/overview">Triage > Alerts</a>. It can also propose
    new detection rules or track blocking observability gaps.
  </Step>
</Steps>

## Understanding threat statuses

Threats move through derived statuses as Cotool learns more about them:

| Status           | Meaning                                                                           |
| ---------------- | --------------------------------------------------------------------------------- |
| **Hunting**      | A Hunt assessment is running right now.                                           |
| **Active**       | Hunt created an open alert that needs attention.                                  |
| **Blocked**      | Hunt could not reach a verdict because required telemetry was missing.            |
| **Monitoring**   | Some residual exposure remains and is being watched.                              |
| **Covered**      | An existing detection already covers this threat.                                 |
| **Clear**        | No meaningful exposure was found in your environment.                             |
| **Resolved**     | The Hunt alert for this threat was investigated and closed.                       |
| **Dismissed**    | A user manually dismissed the threat.                                             |
| **Not relevant** | The threat does not apply to your environment, so Hunt did not pursue it further. |

<Note>
  **Active** and **Resolved** follow the linked Hunt alert. For those threats,
  the source of truth is the alert workflow in{' '}
  <a href="/alerts/working-alerts">Working Alerts</a>.
</Note>

## Add and manage intel sources

Go to **Hunt > Intel Sources** to manage what Hunt ingests.

You can add three custom source types:

* **RSS feed** for vendor blogs, advisories, and newsletters
* **MISP server** for private or public MISP-backed feeds
* **TAXII server** for STIX 2.1 collections

The Intel Sources page shows:

* Source health
* Last sync time
* Item volume over the last 24 hours
* Whether the source is enabled

Built-in sources are managed by Cotool and appear automatically. For custom
sources, you can enable or disable them, edit them, trigger a sync, or delete
them when you no longer want their intel in Hunt.

<Note>
  TAXII and MISP sources can use public feeds or authenticated servers. If
  your server requires a token, provide it when you create the source.
</Note>

## Use the Intel Feed

The **Intel Feed** is where you review individual ingested intel items before or
alongside threat-level analysis. Use it when you want to:

* See which sources are producing new material
* Open a specific advisory, post, or report
* Trace a threat back to the underlying intel that produced it

The feed complements the **Threats** catalog:

* **Intel Feed** = individual source items
* **Threats** = durable, tracked threat records

## Ingest a report from chat with `/hunt-intel`

If you already have a report URL, the fastest workflow is chat:

<Steps>
  <Step title="Start a chat command">
    In chat, type <code>/hunt-intel</code>.
  </Step>

  <Step title="Paste the report URL">
    Provide the URL of the advisory, blog post, or threat report you want
    Hunt to process.
  </Step>

  <Step title="Review the ingest result">
    Cotool runs the Hunt intel pipeline and streams progress in the chat
    timeline.
  </Step>

  <Step title="Continue from Hunt">
    From there, review the resulting intel item or threat record in the Hunt
    product area for follow-up.
  </Step>
</Steps>

## Work a threat

Open **Hunt > Threats** to review the durable threat catalog.

The Threats page supports:

* **Grouped view** for status-based triage
* **Table view** for scanning and sorting
* **Board view** for a kanban-style workflow
* Search by threat key, title, aliases, and actor
* Filters for status, type, result, coverage, and actor

Open a threat to see its detail page. Depending on the threat, that page can
include:

* The latest assessment summary
* Exposure and relevance indicators
* Assets and evidence tied to the threat
* Detection coverage
* Proposed detection rules
* Blocking telemetry gaps
* A linked Hunt alert
* A full activity timeline

If new intel arrives or your environment changes, use **Reassess** to rerun the
Hunt workflow for that threat.

## Related pages

<CardGroup cols={2}>
  <Card title="Alerts overview" href="/alerts/overview" icon="bell">
    See how Hunt findings turn into triage work items.
  </Card>

  <Card title="Working alerts" href="/alerts/working-alerts" icon="list-check">
    Investigate and close Hunt alerts when exposure needs action.
  </Card>
</CardGroup>
