---
name: screentime
description: On-demand, read-only read of this Mac's local Screen Time data (the knowledgeC.db app-usage store). Use when the owner asks "screen time", "where did my time go", "how long was I on X", "what apps did I use most this week", "was yesterday focused", or "how late did I work". The owner asks in plain language — never make them run a command. The agent runs the reader as plumbing and answers with the story — headline hours vs the recent average, what dominated, the deep-work block, late-night flags — not a table dump. Read-only against the source; its only writes are its own committed history files. Records THIS Mac only (no iPhone/iPad data), runs locally, needs macOS Full Disk Access. NOT comms triage (that's attention-digest), NOT texts (that's imessage), NOT vault growth (that's vault-stats). Requires the screentime module.
---

# screentime — folder-root adapter

The real playbook lives in the brain: **`Agent/skills/screentime.md`** (this folder
is the vault root). Read that file and follow it exactly as written, using the
shipped CLI at `.alexandria/app/.venv/bin/alexandria` wherever it says
`alexandria`, and `.alexandria/app/.venv/bin/python` for
`python -m alexandria_vault.…` entrypoints.

If `Agent/config.json` does not exist, nothing is installed yet — stop and
follow `./CLAUDE.md` (the installer) instead of this skill.
