# Settings

Settings persist under `~/.config/peardata` (or `PEARDATA_HOME`) for desktop prefs. Agent storage policy is stored on the agent itself.

## Appearance

| Setting | Notes |
|---------|-------|
| **Theme** | Light / dark |
| **Accent / density / motion** | Visual prefs for the desktop shell |

## Charts / Overview

| Setting | Notes |
|---------|-------|
| **Overview spark depth** | Sample count when Charts has no overriding window |
| **Default spotlight chart** | Chart id for Overview explore (e.g. `system.io`) |

## Data Manager

Controls **agent-side** history so disks and RAM stay bounded. Requires an **admin** connection to the agent.

| Control | What it does |
|---------|----------------|
| **Usage cards** | Total data dir size, Corestore size, in-memory hot/warm points, warm HyperDB sample |
| **Hot memory** | 1s ring depth (15m → 24h presets or custom points) |
| **Warm memory** | Downsampled in-RAM ring + samples-per-bucket |
| **Disk history** | Auto-rotate by age (default **3 months**; also 1 day → forever, or custom days) |
| **Soft disk budget** | Corestore size target that triggers extra prune (default **1 GiB**; `0` / Unlimited = none) |
| **Max warm points** | Hard cap on stored warm samples (`0` = unlimited) |
| **Auto prune** | Scheduled prune interval (hours; default on) — also runs physical GC |
| **Dry-run / Prune now** | Preview deletes or prune + reclaim disk (`clearUnlinked` + compact) |
| **Save to agent** | Applies live + writes `retention.json` on the agent |

Default warm retention preset is **3 months** with a soft **1 GiB** corestore budget. Prune deletes expired warm points then runs Hyperbee `clearUnlinked` + Hypercore `compact` so disk is actually reclaimed. Env seeds (`PEARDATA_TIER*`, `PEARDATA_WARM_*`) only apply when no `retention.json` exists yet. See [CONFIGURATION.md](../docs/CONFIGURATION.md) and [STORAGE-HYPERDB.md](../docs/STORAGE-HYPERDB.md).

## Connections

| Setting | Notes |
|---------|-------|
| **Restore saved agents** | Auto-dial peers on launch |
| **Max reconnect attempts** | Cap for background dial retries |

## Notifications

Desktop notification toggles for alerts (when the runtime supports them).

## Reset

Clearing local desktop prefs does not delete agent data. Use **Data → Prune now** or tighten retention to reclaim warm history on the agent.