One timer across your devices

• A workspace on both devices, through GitHub, your server, iCloud, or a folder in Files.
• Version 1.2 on both. A device on an older version keeps its own timer, as before, and nothing breaks.
• In a team workspace, your name on each device, as below.

A workspace that lives on one device works as it always did: the timer stays on that device.

1. 1Start the timer on a task, on any device.
2. 2Open nokko on the other device. The running timer appears, and on iPhone the Time tab says where it began: Started 12:58 on Laurynas's iMac.
3. 3Press Stop on either device. On iPhone, that includes the Lock Screen card.
4. 4The other device lets go. The Mac tells you, for example: Stopped on iPhone — 1h4m was logged there.

On the Mac, a timer started elsewhere shows Started on iPhone · follows you when Nokko syncs in the menu bar popover. Pomodoro stays on the Mac and is not shared. See timers and timesheets.

nokko has no server of its own, so the news travels through your workspace's normal sync. This is near enough to live, but not instant.

Whichever device you press Stop on writes the ⏱ line, and only that one. The stop time is the moment you pressed. Before writing, that device asks the workspace for the latest news for up to five seconds, and skips this when offline.

- [ ] Review the invoice
  - ⏱ 2026-11-03 12:58-14:02 (1h4m)

You might start a new timer elsewhere without stopping the old one. The device that started the old timer then writes it, up to the new start. A device that is offline keeps its span and writes it when it comes back. Under a minute writes nothing, as always, and on iPhone or iPad Discard Without Logging writes nothing either.

On disk, each device keeps one small file of its own, .nokko/clock/<device id>.json. It is the one thing inside .nokko that travels with sync. Because only that device writes it, these files never conflict.

On your own there is nothing to set up. With two or more people in People/, a device follows only devices that say they are the same person. So a teammate's timer never appears on your phone.

• On iPhone or iPad: go to Settings ▸ You in This Workspace and choose your name under You Are. If a person's file has your GitHub login, nokko fills this in for you.
• On the Mac: open People and choose This is me on this Mac on your name.

This is a label, not a login, so anyone can choose any name. It also signs your ⏱ lines with @Name. If your timer does not follow you in a team workspace, check that both devices show the same name. See people and conflicts.