User Guide

Everything you need to know about Time on Deck v2.0

Daily Log Basics

Track your time with natural language in plain text files

File Structure

Daily logs are stored in a hierarchical directory structure:

./data/DayLog/team/[username]/[year]/[month]/[date].txt

Example: ./data/DayLog/team/kate/2025/11/2025-11-10.txt

Basic Syntax

Simple time entry:

3h Design homepage mockups

With project and category:

2.5h Backend API development >acme-website #development

With planned time:

Write user documentation >platform #content (4h)

The (4h) indicates you planned 4 hours for this task

Mark as done:

2h Bug fixes >platform #development [done]

Pro tip: Use the autocomplete feature! Type > for projects or # for categories to see suggestions from your existing data.

File Sections

Organize your day with these standard sections:

## Plan:
3h Design review >acme-website #design
2h Sprint planning meeting >internal #admin

## Unplanned:
1h Emergency bug fix >platform #development [done]

## Notes:
- Discussed new feature requirements
- Team meeting rescheduled to Thursday

Dashboard & Period Filtering

View your metrics filtered by time period

The Dashboard tab shows your productivity metrics with the ability to filter by:

Today - Tasks and hours logged today
This Week - Weekly summary (Monday-Sunday)
Last Week - Previous week's totals
This Month - Month-to-date statistics
Last Month - Previous month's complete data

Each period shows: hours logged, planned vs actual, projects count, task completion rate, and breakdowns by project and category.