Cardinal by RAMCOREOpen Cardinal

Track your own work (Mac collector)

Time and tracking · Mac. How the workspace owner installs the collector on their Mac so Worth it, Timesheet, Projects and the other tracker pages fill up.

The owner's tracker pages (Worth it, Timesheet, Projects, Clients, When you work, Trends) are filled by the runner on the owner's computer, installed from the Setup page. The runner reads Claude Code's session history on that computer and sends the numbers to Cardinal every hour. Do this once, on the computer you work on.

What you need

  • A copy of the Cardinal code on the Mac, with its packages installed (pnpm install in that folder), for the cardinal command and /hours. If you don't have one, ask us to set it up.
  • Node.js 20 or later, and the Claude Code CLI signed in.
  • A sync key from Settings › Tracking, sync and data › Sync key.

Run the first commands from the Cardinal folder as pnpm cardinal .... Step 3 adds a cardinal command in ~/.local/bin, so after that cardinal ... works from anywhere, as long as ~/.local/bin is on your PATH.

1. Point it at Cardinal

Create ~/.config/cardinal/config.json with your Cardinal address as apiUrl, for example { "apiUrl": "your Cardinal address" }.

2. Add the sync key

  1. Open Settings › Tracking, sync and data › Sync key and rotate to get a new key. It is shown once. Copy it.
  2. In the Cardinal folder, run pbpaste | pnpm cardinal set-key. The key goes into the settings file, readable only by you, and is never shown in Terminal.

3. Add the cardinal command and /hours

Run pnpm cardinal install-command. It writes ~/.local/bin/cardinal and the /hours command for Claude Code, and saves where your claude is. Then /hours sync in Claude Code syncs now, and /hours status shows your hours. See "The owner's Mac collector and /hours".

4. Sync every hour

Nothing more to install. The runner from the Setup page syncs your sessions every hour, on a Mac or on Windows, and keeps its state in its own folder. The old cardinal install-launchd login item is retired: if you still have it, cardinal install-launchd now only tells you so, and the runner takes over. A computer with no runner needs the install line from Setup first.

Check it worked

After the first sync, Settings lists the computer under sync, with when it last synced. Worth it and Timesheet show your sessions. If Settings shows "stale", the hourly sync has stopped: it shows the last error under the computer. Today also shows "Time sync stopped" and sends one push when a computer that is awake stops syncing.