> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/cw-tracker.md).

# CW Tracker

Use this page to control the local CW Tracker state used by CrossWatch.

CW Tracker stores local watchlist, history, and ratings data under `/config/.cw_provider`.

### Tracker state

#### Enabled

Turn CW Tracker on or off.

* `Enabled` — CrossWatch keeps the local tracker active
* `Disabled` — tracker writes stop

The restore selectors can still appear when the tracker is disabled.

Do not use them until the tracker is enabled again.

#### Retention (days)

Set how long tracker snapshots stay on disk.

* `0` — keep snapshots forever
* Any value above `0` — keep snapshots for that many days

#### Auto snapshot

Choose whether CrossWatch creates a snapshot before tracker writes.

* `On (before writes)` — create a pre-write snapshot automatically
* `Off` — do not create automatic snapshots

#### Max snapshots per feature

Limit how many snapshots CrossWatch keeps for each feature.

This applies separately to:

* Watchlist
* History
* Ratings

Values:

* `0` — unlimited
* Any value above `0` — keep only that many snapshots per feature

### Restore selectors

CrossWatch shows separate snapshot selectors for:

* `Watchlist snapshot`
* `History snapshot`
* `Ratings snapshot`

Each dropdown lists the snapshot files available for that feature.

#### Latest (default)

Use the latest tracker state for that feature.

#### Specific snapshot

Choose a saved snapshot when you want CrossWatch to use that tracker state instead.

{% hint style="info" %}
This is not the same as a full restore.

It changes the tracker state CrossWatch reads for that feature.

Use [Captures](/crosswatch/tools/captures.md) when you need a broader restore workflow.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wiki.crosswatch.app/crosswatch/navigation/ui-settings/cw-tracker.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.