Time Tracking

Track time spent on your work with a built-in stopwatch timer. Optionally link time entries to projects and tasks for detailed reporting.

Timer

The timer is always accessible from the navbar. Click the clock icon to expand the timer dropdown.

  • Start: Enter a description, optionally select a project and task, then click "Start Timer"
  • Stop: Click "Stop Timer" when you're done
  • One timer at a time: Starting a new timer automatically stops any running timer

The timer persists on the server, so it survives page navigation and browser refreshes.

Time Entries

View all your time entries at /time_entries. Entries are grouped by day with daily totals.

Filters

  • Project: Filter entries by project
  • Date range: Filter by start and end dates

Manual Entry

Add time entries manually with custom start and end times using the "Manual Entry" form on the index page.

Reports

Access detailed reports at /time_entries/reports. Reports include:

  • Summary stats: Total time, number of entries, average per day, days tracked
  • Daily chart: Bar chart showing hours per day
  • Project chart: Pie chart showing time distribution by project
  • CSV export: Download all entries as CSV

Report Filters

  • Filter by project
  • Filter by date range

Dashboard Integration

Each project's Dashboard tab shows a "Time Tracked" card with:

  • Time tracked this week
  • Total time tracked (all time)
  • Recent 5 time entries with links

Click "View Reports" to see filtered reports for that project.

Quick Actions

Start a timer from the dashboard Quick Actions section:

  1. Click the "Timer" button
  2. Enter a description
  3. Optionally select a project
  4. Click "Start Timer"

Time entries are searchable via the global search (Cmd+K). Search matches against entry descriptions.

Keyboard Shortcuts

  • Cmd+K: Open search (includes time entries)
  • Cmd+P then type "time": Navigate to Time Tracking or Time Reports

Tags

Time entries support tags from the same tag system used by tasks, notes, and files.

REST API

A complete REST API is available for time entries: list, get, create, start,
update, stop, delete, current running entry, and reports (daily + per-project totals).
See the API documentation for details.