You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/usage.md
+21-14Lines changed: 21 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -101,6 +101,7 @@ View your time tracking history.
101
101
-`--project "name"` - Filter entries by project name
102
102
-`--today` - Show only today's entries
103
103
-`--week` - Show this week's entries
104
+
-`--date` - Show a specific date's entries
104
105
105
106
**Examples:**
106
107
@@ -111,6 +112,7 @@ tmpo log --project "Client Work" # Filter by global project
111
112
tmpo log --milestone "Sprint 1"# Filter by milestone
112
113
tmpo log --today # Show today's entries
113
114
tmpo log --week # Show this week's entries
115
+
tmpo log --date "2026-01-15"# Show January 15th, 2026 entries
114
116
```
115
117
116
118
### `tmpo stats`
@@ -122,13 +124,15 @@ Display statistics about your tracked time.
122
124
-`--today` - Show only today's statistics
123
125
-`--week` - Show this week's statistics
124
126
-`--month` - Show this month's statistics
127
+
-`--date` - Show a specific date's statistics
125
128
126
129
**Examples:**
127
130
128
131
```bash
129
132
tmpo stats # All-time stats
130
133
tmpo stats --today # Today's stats
131
134
tmpo stats --week # This week's stats
135
+
tmpo stats --date "2026-01-15"# January 15th, 2026 entries
132
136
```
133
137
134
138
## Configuration
@@ -232,14 +236,18 @@ Milestones help you organize time entries into time-boxed periods like sprints,
232
236
233
237
### `tmpo milestone start [name]`
234
238
235
-
Start a new milestone for the current project. All new time entries will be automatically tagged with this milestone until you finish it.
239
+
Start a new milestone for the current project, or the one specified. All new time entries will be automatically tagged with this milestone until you finish it.
240
+
241
+
**Options:**
242
+
243
+
-`--project "name"` / `-p "name"` - Start a milestone for a specific global project
Finish the currently active milestone for the current project. This stops auto-tagging new entries and marks the milestone as completed.
261
+
Finish the currently active milestone for the current project, or the one specified. This stops auto-tagging new entries and marks the milestone as completed.
262
+
263
+
**Options:**
264
+
265
+
-`--project "name"` / `-p "name"` - Finish a milestone for a specific global project
254
266
255
267
```bash
256
268
tmpo milestone finish
257
-
# Output:
258
-
# [tmpo] Finished milestone Sprint 1
259
-
# Duration: 2w 3d 5h 30m
260
-
# Entries: 47
269
+
tmpo milestone finish --project "GlobalProject"
261
270
```
262
271
263
272
### `tmpo milestone status`
264
273
265
274
Show detailed information about the currently active milestone.
266
275
276
+
**Options:**
277
+
278
+
-`--project "name"` / `-p "name"` - Show milestone status for a specific global project
0 commit comments