Skip to main content

Analytics & Stats

td tracks usage patterns and system health locally. All data stays on your machine.

Command Usage Statistics

td stats analytics

Shows which commands are used most, frequency patterns, and usage over time.

Security Audit Log

td stats security

Shows self-close exceptions (when issues were closed without proper review workflow).

Error Tracking

td stats errors

Shows failed command attempts - useful for debugging agent issues.

Monitor Stats

Press s in the monitor to view:

  • Status breakdown bar chart
  • Type and priority distributions
  • Summary metrics (total, points, completion rate)
  • Timeline data
  • Activity stats (logs, handoffs, most active session)

Disabling Analytics

export TD_ANALYTICS=false

Set this environment variable to disable local analytics collection.

Data Storage

All analytics stored in local SQLite database (.todos/db.sqlite). Nothing leaves your machine.