Download the desktop app
The desktop app records which app is in front and its window title, along with when you were idle, and never a page's address. It keeps all of it on your computer first, then syncs it to your timeline, where you turn it into entries. You decide what it sees: an allow and deny list for apps and titles (password managers, banking, anything you name), a pause, and a private mode that records app names only.
macOS
macOS 10.15 Catalina or later, Apple silicon and Intel.
Windows
Windows 10 or 11, 64-bit.
The installer is not signed yet, so your browser may stop the download. In Edge, which says it isn’t commonly downloaded: open the download’s … menu and choose Keep, then open the arrow beside Delete and choose Keep anyway. In Chrome, which calls it suspicious: open the arrow beside Delete and choose Download suspicious file. If Windows then shows a “Windows protected your PC” prompt, choose More info, then Run anyway.
Then sign in from the app
Open Clockwork and choose Sign in. Your browser opens; sign in with your Clockwork account and allow Clockwork Desktop. On a Mac the app then asks for the Accessibility permission it reads window titles with.
No account yet? Sign up first. The setup guide has the rest.
The command line tool
For the timer in a terminal and your Claude Code sessions as agent runs. Install it with one command. On macOS or Linux:
curl -fsSL https://clockwork.am/install.sh | sh
On Windows, in PowerShell:
irm https://clockwork.am/install.ps1 | iex
Then run clockwork hooks install claude to sign in and connect Claude Code. Running the install command again upgrades it.
macOS, Linux and Windows: Apple silicon/arm64 and Intel/x64 on macOS and Linux (glibc, so not Alpine), x64 on Windows. More in the setup guide.
On Windows, the command line tool is not signed yet. Installed with this command it runs without the “Windows protected your PC” prompt, which is for files a browser downloads; but with Smart App Control on, Windows blocks unsigned programs, and it will not run until it is signed.