How to use TempusLog
Short how-tos for the things people ask most. Can't find it? Email contact@mile.dev.
Start a timer
- Open Track. In the bar at the top, type what you are working on.
- Pick a project (and a task or tags if you use them). The $ button marks the time as billable.
- Press Start. The timer keeps running when you close the tab or switch devices.
- Press Stop when you are done. Stopped by mistake? The message offers Resume, and the same timer carries on. Timers shorter than a minute log nothing.
Add time afterwards
- Type a duration in the timer field, like 1h30, 90m, 1.5 or 1:30, and press Add.
- Or switch the bar to Manual entry (the list icon next to the timer) to set the date, start and end.
- On the calendar, drag over empty time to add an entry, or drag an entry to move it.
- After you add one, the next entry starts where it ended, with the same length.
Fill in a whole week (Timesheet)
- On Track, open Timesheet (on a computer). Each row is a project and task, each column a day.
- Click a day and type how long you worked, like 2, 1h30 or 1:30. It saves when you press Enter or Tab. Type 0 or clear it to remove that day's time.
- + Add row picks a project and task. Copy last week brings over last week's rows, with or without the hours.
- A day with several entries shows their total. Typing a bigger number adds the difference; a smaller one trims the latest entries first. The arrow on the row shows each entry, and the ⋯ on a day opens its description and tags.
Change or delete an entry
- Click any part of an entry and change it. It saves as soon as you leave the field.
- On a phone, tap the entry to open it, then change it or tap Delete.
- Several at once: tick them in Reports, Detailed or in the Track List on a computer. A bar at the bottom offers Edit (project, task, tags, billable) and Delete, both with Undo.
- The play button on a past entry is Track again: a new timer with the same task.
- In the List, entries of a day with the same description, project, task, tags and billable share one row with a count and their total. Open it with the arrow to edit each entry. Point at the count to see the week's total. Turn grouping off with the gear next to the view buttons.
Keyboard shortcuts
- Cmd+K (Ctrl+K on Windows) opens a menu for everything: start or stop the timer, track a recent task again, go to a page, switch workspace.
- On Track: S starts or stops the timer, N jumps to the description, M switches timer and manual entry, T goes to this week, the arrow keys change the week, and 1, 2, 3 switch Calendar, List and Timesheet.
- While typing a description: + picks a project, @ a task and # a tag.
- Single keys are off at first, so a stray key never starts a timer. Turn them on in Settings, Personal. They never work while you type in a field; press ? for the list. Cmd+K and + @ # always work.
Invite your team
- Open Team and use Invite people. Add one or more email addresses.
- Each person gets an email and joins with Google or a password.
- Admins manage everything except owner-only actions. Members log their own time on the projects they can access.
Choose who sees a project
- Open Projects, then the project, then Access.
- Add people (also people who haven't accepted their invite yet) and remove them any time.
- Owners and admins can make someone a Project admin: they manage the project's Members and log time for them.
- To log time for someone, press the initials button at the end of the Track bar's buttons and pick them. It turns sand colored and the calendar shows their time until you go back to yours.
Reports and exports
- Open Reports. Summary groups time by project, client, person, task or tag. Detailed lists every entry.
- Pick a range (This week, Last month, This year, or Custom) and filter by person, client, project, task, tag or billable.
- Press Export and pick PDF, Excel or CSV. The export uses the same range and filters.
- Want hours as 5.50 instead of 5:30? Click Total or Billable. Click again to switch back.
- The gear at the end of the table's header hides columns on screen and shows Amount if you see money. Exports always stay complete.
- Owners and admins choose what exports contain in Settings, Export format, Columns. The PDF shows both 5:30 and 5.50.
- Press Share for a read-only link to exactly what's on screen. The dates and filters stay fixed, so a September report stays September. A link works for 30 days. Revoke it sooner from the same menu.
- Coming from Clockify, Toggl or Harvest? In Settings, Export format, pick that tool: the CSV gets the same columns as its export, so your scripts and spreadsheets keep working.
Hourly rates and amounts (Finance)
- An agreement is what a client pays you: an hourly rate for one or more projects. Example: Acme pays €50 an hour for Website and App. Ana logs 10 billable hours on Website, so Reports shows €500.
- Open Finance (owner and admins) and press New agreement. Name it, type the rate and pick the currency, then add its projects. Or type a rate on a project's Details, which creates the agreement for you.
- Rates per person: if someone bills differently on these projects (a senior at €70), add them with their rate. Everyone else bills at the agreement rate.
- Dates are optional. A new price next year is a new agreement starting on its date. A project has one agreement on any given day.
- Only billable time earns money. Time on a project starts billable when the project's $ is on, and adding a project to an agreement switches it on. Time without a project starts non-billable.
- Changing a rate shows what changes before saving, and asks how to apply it: From today keeps past reports as they were, Also past entries uses the new rate everywhere. Rate history on the agreement shows each rate and when it applied.
- In Reports, open the gear and tick Show amounts to see amounts in the totals and as a column. Exports fill the rate and amount columns. Amounts in different currencies are never converted.
- Rates and amounts are for owners and admins. To let a Project Admin see them on one project, open the gear next to their role in the project's Access and tick Sees money. Members never see money.
- New agreements start with the currency from Finance, Settings.
Import from Clockify, Toggl or Harvest
- Open Settings, then Import from another tool (owner and admins only), and pick the tool.
- Clockify: paste an API key, or upload a Detailed report CSV. Toggl Track: paste the API token from Profile settings. Harvest: paste a personal access token from id.getharvest.com/developers.
- Step by step: Import from Clockify, Import from Toggl Track, Import from Harvest.
Install TempusLog on your phone or computer
- iPhone: open tempuslog.com in Safari, tap Share, then Add to Home Screen.
- Android: open tempuslog.com in Chrome, tap the menu, then Add to Home screen or Install app.
- Computer: in Chrome or Edge, click the install icon at the right end of the address bar, or open the menu and choose Install TempusLog. It opens in its own window and can be pinned to the dock or taskbar.
- Without a connection, pages you've opened before still open and show what was loaded; changes save once you're back online. A running timer keeps counting.
Connect an AI app
- Claude: open TempusLog in Claude's directory and press Connect.
- ChatGPT: open TempusLog in ChatGPT's plugins and press Install plugin.
- Log in to TempusLog when it asks (or sign up; you come back to this step), pick Read only or Read and log time, and press Allow.
- If you see money in the app, your AI can report amounts too. It never changes rates.
- Cursor, VS Code, Claude Code and Codex: open Settings, AI apps in TempusLog for a one click button or the command to paste.
- To disconnect, press Disconnect next to the app in Settings, AI apps. More on the AI page.
API keys
- Open Settings, API keys and press Create API key. Pick Read only or Read and write.
- Copy the key right away. It's shown only once.
- Delete a key in the same place and it stops working at once. Endpoints and examples: API docs.
Your account
- Set your own weekly goal by clicking the week total on Track, or in Settings, Personal. Track then shows one bar for the week instead of each day.
- Your timezone is taken from your browser the first time you sign in. Change it in Settings, Personal, Timezone.
- Download everything you logged as a file with Download my data in Settings, Personal.
- Delete your account yourself in Settings, Personal.
- Forgot your password? Use Forgot password on the login page.
- Found a bug or have an idea? Use Send feedback at the bottom of the menu, or ask your AI app to send it. We read every message.
Emails we send
- Sign in, password reset, invites and import results always come. A new account gets one email: the welcome, with the confirmation link when you signed up with email. Nothing else is sent without a switch.
- Timer still running (on): one email when a timer has run for 10 hours, in case you forgot to stop it.
- Month-end reminder (on): on the month's last workday, only when some workdays have nothing logged. It names them. Days off need nothing.
- Weekly team report (off, for owners and admins): Monday morning, last week's total, top projects and everyone's hours.
- Turn each one on or off in Settings, Personal, Emails. Every one of these emails links there.
Your workspace
- Owners and admins can make fields required on every entry (project, task, tags, description) in Settings, Workspace, Required fields. A timer needs the project to start and the rest to stop. With description required, the Timesheet is off.
- Owners can hand the workspace to another member in Settings, Ownership.
- Owners can delete the workspace with all its projects and time in Settings, Ownership. You type its name to confirm.