Timers and timesheets

The mini timer also opens from View ▸ Mini Timer and from Timer in the window toolbar. You can change its key in Settings ▸ Timer. Type what you are doing in What are you working on?, and those words become the note on the entry. In the menu bar, the same field reads Add a note to this entry….

Task ▸ Continue Last Timer (⌥⌘R) starts again on whatever you logged last, note included. The star beside a recent entry in the mini timer pins that task as a favourite, which puts it in the menu bar and on the medium widget.

Clicking Start Timer itself in the menu bar starts the clock with no task. When you stop, the time goes into Time/Unassigned.md under that day. Give it a task from the Timesheet before you invoice, because until then it belongs to no client.

A widget press counts from the moment you pressed it. If nokko is closed, it acts on the press at next launch, so a stop pressed at 14:02 still ends the entry at 14:02.

• Open a task and tap Start Timer. If another task is timing, the button reads Switch the Timer to This Task, and the running task's time is written first.
• On the Time tab, tap Start Without a Task, or the play button beside a task under Timed This Week.
• While it runs, the Lock Screen and the Dynamic Island show the task, the clock and Stop. Tap Stop there, or on the Time tab.
• Discard Without Logging on the Time tab ends the timer and writes nothing.

The iPhone keeps its own timer, separate from the Mac's. It counts from a start time, so it survives the phone locking, the app closing and a restart. There is no idle detection on iPhone, so a timer you forget keeps counting.

A task's page lists its entries, but you cannot add or edit an entry on iPhone. Do that on the Mac. Time started without a task lands in Time/Unassigned.md, and you give it a task on the Mac.

Stopping adds one line under the task, in the same Markdown file. The note follows a dash when you typed one. ⌘Z removes the line.

- [ ] Homepage design
  - ⏱ 2026-11-03 09:15-12:30 (3h15m) — first pass at the hero

If this Mac knows who you are, your name goes after the duration, as in (3h15m) @Laurynas. The duration in brackets is only for people reading the file. nokko always works the total out from the two clock times, so editing the label changes nothing.

• Under a minute writes nothing. You see Under a minute; nothing was logged.
• A timer left running for more than a day logs 23h59m and says so.
• If the task cannot be found when you stop, the time is held and written once the task is recognisable again. On iPhone it waits under Held on the Time tab.

A running timer notices when the Mac goes quiet. The default is 10 minutes. Change it in Settings ▸ Timer ▸ Idle detection: Off, or 5, 10, 20 or 30 minutes. Sleep always counts as away, whatever its length, even with Off.

When you come back, the mini timer opens and says how long you were away. The menu bar and the window ask the same thing.

If you ignore the question and stop later, nokko writes two entries, one either side of the break. The away time itself is left out.

A focus session is a countdown in the menu bar with a notification at the end. It writes nothing to your files and does not touch the timer. Start one with Task ▸ Start Focus Session (⌃⌘F), or Focus in the menu bar when no timer is running.

Sessions last 25 minutes with a 5 minute break unless you change them in Settings ▸ Focus. Session offers 15, 25 or 50 minutes, and Break offers 3, 5, 10 or 15.

Three switches are off until you turn them on: Start the break automatically, Start the next session automatically and Stop the timer when a session ends. The last is the only way a session affects your logged time.

On the same pane, Remind me when no timer is running sends a quiet nudge between the hours and on the days you choose.

1. 1Open the task panel and click Add Entry in the Time section. In the Timesheet, you can instead click the plus on a day that already has an entry and answer Log to which task?. For an empty day, use Add Entry.
2. 2Type the day as 2026-11-03 and the span as 09:15-10:30. The note is optional.
3. 3Click the tick, or press Return in the note field. One ⏱ line is added under the task.

To change an entry, hover over it in the task panel or the Timesheet and click the pencil. The minus deletes it, and ⌘Z puts it back. In the Timesheet, entries from Time/Unassigned.md also get a button that assigns them to a task.

Two entries can claim the same minutes, for example a Mac timer and an iPhone timer left running together. nokko does not fix this for you, and both entries count towards an invoice.

You see it in two places. The Timesheet prints a line between the entries, such as · overlaps the previous entry by 30m. Saving an entry on the Mac that overlaps another on the same day also posts a notice, Time overlap on followed by the date, naming both tasks. An entry that arrives from iPhone by sync posts no notice, so check the Timesheet.

To fix an overlap, edit one of the entries in the Timesheet. The system notification can be turned off in Settings ▸ Notifications ▸ Time overlaps.

The Time view answers three questions, one per segment at the top left. A range menu, the back and later arrows, and the Client and Tag filters narrow what you see. It opens on This month, and the Timesheet starts on This week.

Time on iPhone is a different screen. It shows the running timer, the last seven days by board, and Not Invoiced Yet. The Summary, Timesheet and Workload are on the Mac only.

In Summary or Timesheet, choose Export ▸ Markdown… or Export ▸ CSV…. The file holds exactly what the range and filters show, so set the Client filter before you send one to a client. It is saved where you choose, and nothing is added to your workspace.

The two segments export different things. The Timesheet gives one row per entry, with clock times and notes. Summary gives one row per task. Export is greyed out when the range holds no time, and Workload has no export.

Date,Start,End,Minutes,Hours,Client,Space,Project,Task,Note

From,To,Client,Space,Project,Task,Minutes,Hours,Spans