Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Data

  1. Where
  2. What the database keeps
  3. Backups and imports

1. Where

On the hub:

WhatWhere (NixOS module)
Live statehub memory, one reducer per host
History/var/lib/ccdash-hub/ccdash.db (SQLite, WAL), ccdash user
Backups/var/lib/ccdash-hub/backups/, nightly, checked
State sync/var/lib/ccdash-hub/claude/, plain files (not in backups)
Catalog/var/lib/ccdash-hub/catalog.db, past sessions read from the synced transcripts
Workspace/var/lib/ccdash-hub/claude/workspace/<unit>.git, bare repos
Reports/var/lib/ccdash-hub/reports/<workspace>/<slug>.html, plain files (not in backups)
Config/etc/ccdash/hub.toml

On each workstation the collector keeps only what it cannot deliver yet:

WhatWhere
Mirrorcollector memory (this machine’s sessions, for DMS and the CLI)
Outbox~/.local/state/ccdash/outbox.ndjson, bounded
Notes~/.local/state/ccdash/notes-cache.json
Sync~/.local/state/ccdash/sync.db (what is in step)
Workspace~/.local/state/ccdash/workspace/ (hidden gitdirs of plain units, temporary indexes, workspace.db, the cached setup)
Config~/.config/ccdash/config.toml
Sockets$XDG_RUNTIME_DIR/ccdash/ (ingest.sock, api.sock)
Telemetry127.0.0.1:7839 (OTLP/HTTP JSON), when enabled

2. What the database keeps

Every row carries the host it came from. Kept for store.retention_days (30 by default):

TableHolds
eventsprompts (up to 8 KiB), task notifications, subagent messages and Claude’s messages and replies (up to 32 KiB), tool calls (name, path or first command line, duration, output up to 8 KiB), permission requests and answers, tasks, subagents, compactions, state changes, resolved marks
samplesonce a minute per session from the statusline: context, cost, limits, model, lines
proc_samplesonce a minute per session: CPU, memory, process count
sessionsid, directory, title, kind, start and end, branch
limit_samplesper-model weekly limits from each /usage poll
telemetrywith telemetry on: API requests (tokens, cost, latency), errors, approvals, commits, edits, active time
session_messagesmessages between sessions and from you

Claims end with their session or their deadline; revoked device tokens go after a while. Not pruned: notes, links, notes_fts (knowledge), live device tokens and their push subscriptions, sync_files, sync_history, sync_conflicts, sync_growth (state sync), workspace_units, workspace_refs, workspace_conflicts, workspace_config, workspace_seen (workspace sync; workspace_events keeps 90 days).

The catalog (catalog.db next to the database, SQLite) is what Sessions › Past searches: a row per transcript the state sync holds (titles, first and last prompt, Claude’s last text, dates, size, numbers, the machines that wrote it) and every prompt and block of Claude’s text (up to 16 KiB each) with a full-text index. It is derived only: the nightly copy leaves it out, deleting it (hub stopped) rebuilds it from the transcripts, and a new version of what it extracts rebuilds it by itself. Nothing is pruned; a transcript that grows is read from where it stopped, one replaced is read again.

3. Backups and imports

ccdash backup --config /etc/ccdash/hub.toml copy.db   # what the nightly timer runs
ccdash import db old.db --config /etc/ccdash/hub.toml # history of a pre-hub daemon, safe to repeat

The nightly copy goes through SQLite’s backup API and is checked with PRAGMA integrity_check; backup.keep copies are kept. Delete the database to start over.