ANSWER EVERY
TIME.MD QUESTION.
Guides for installing time.md, granting macOS permissions, reading every analytics screen, exporting your data, troubleshooting common issues, and connecting local data to Terminal or MCP-compatible agents.
Setup and first launch
New to time.md? These pages explain what the app needs from macOS, how the card-backed trial and paid license work, and how to recover when permissions or activation get stuck.
Getting Started
Download, install, complete onboarding, start the trial, activate a license, and confirm your first data sync.
02 / PERMISSIONSmacOS Permissions
Full Disk Access, Accessibility, Input Monitoring, and the optional website-blocking helper explained in plain English.
03 / LOCAL DATAWhat Leaves Your Mac?
A practical privacy explainer covering local databases, exports, browser history, license checks, Stripe, and update checks.
Screen-by-screen guides
time.md mirrors its documentation around the app sidebar: Tracking screens, organization screens, and data screens. Use these guides when a metric, chart, or table needs context.
Overview
Total time, daily average, peak hour, app timeline, top apps, and the insight ticker.
TRACKINGReview
Compare app/category usage with bar, pie, trend charts, heatmaps, and detailed breakdowns.
TRACKINGDetails
Inspect individual sessions, top transitions, context switches, app filters, and timeline pagination.
ORGANIZEProjects & Rules
Group apps into meaningful categories, edit mappings, use suggestions, and improve coverage.
DATAReports
Read time distribution, weekday averages, report data tables, and quick report exports.
DATAWeb History
Analyze browsing across Safari, Chrome, Firefox, Arc, Brave, and Edge without cloud sync.
GLOBALFilters & Date Ranges
Use global date, granularity, app, category, weekday, time-of-day, and duration filters.
Advanced features
These guides cover optional or power-user workflows: exporting to knowledge bases, blocking distractions, tracking input locally, and querying data from Terminal or coding agents.
Export & Automation
CSV, JSON, YAML, Markdown, Obsidian, filter presets, custom sections, live auto-export, and schedules.
BLOCKINGWebsite & App Blocking
Simple on/off website and app blocks, helper setup, diagnostics, repair, and safe removal.
OPTIONALInput Tracking
Opt-in keyboard and cursor analytics, redaction safeguards, retention, pause shortcut, and deletion.
POWER USERCLI & MCP
Install the `timemd` command, query local data from Terminal, and expose selected tools to AI agents.
Troubleshooting and support
Troubleshooting
Empty data, missing browser history, activation, exports, blocking recovery, input tracking, CLI, and MCP.
ANSWERSFAQ
Short answers for the questions users ask before and after installing time.md.
RELEASESChangelog
User-facing notes for recent time.md releases and feature changes.
CONTACTSupport
What to try first, what to include in a support email, and where to get license or setup help.
Email [email protected]. Include your macOS version, time.md version, what screen you were using, and any exact error text shown by the app.