ChangelogLatest: 2.3 · 26 October 2026

What's new in Timecard.

Every release of the Mac app, newest first. Updates install themselves, so you're probably already on 2.3. Follow by RSS.

  1. 2.3

    Your year, Wrapped

    Timecard has kept every minute of your year. Now it plays the year back. On 2 December your year is wrapped: see where the time went, scene by scene, and finish with your whole year printed on one long card.

    Your year, played back

    From 2 December, when the year is wrapped, click Play and your year plays in its own window, one scene at a time. Until then the story is sealed; years gone by play any time.

    • Every hour, added up: your total time on the clock, in full days and forty-hour weeks.
    • The year around a clock: every day as a line around a dial, with your longest day lit up.
    • Your top five apps and sites, led by the one you never closed.
    • Where it went: Productivity, Social, Entertainment and Other.
    • Your hours: the hour you peak on an average day, plus your earliest punch-in and latest punch-out.
    • Deep work: your hours in runs of 25 minutes or more, and how many days earned the 3H+ stamp.
    • Month by month and app switches.
    • Your agents' year, if you code with AI: tokens, time and the tools you used.

    Click to go on, hold to pause, use ← → and Space, or press Esc to leave. The story pauses when you switch to another app and carries on when you come back.

    A position for the year

    Timecard reads your year and stamps a title on it, like Day Shift Deep Diver, Night Shift Maker or Early Shift Air Traffic Controller, with the numbers that earned it.

    The annual card

    The story ends with your annual card: your year on one long timecard, with your top apps, totals, records, your position and the stamps you earned. Until the year is wrapped on 2 December it says Year to date and reprints as you go. From then on it's your finished Annual card: Wrapped counts 1 January to 1 December.

    Share it

    Share the card as a story (1080 × 1920) or a post (1080 × 1350), copy it, or save it. It uses the backdrop and paper you last chose for your daily cards.

    On 2 December, the notch tells you

    You don't have to open anything. On 2 December your year is wrapped, and at the first quiet moment the notch widens, cranks through it and stamps your position. Click it, or Play your year, and the whole story plays in Timecard. Or press Print and your annual card feeds out of the notch, like your evening card, to tear off, play or share.

    It only shows when you're at your Mac and not in a call, a full-screen app or a presentation. It never comes near your evening card, shows at most once a day, and stops after three tries.

    Also in the menu bar, Spotlight and Siri

    • The menu bar: from 2 December, a small dot on the Timecard icon means your year is ready. The menu has a Your 2026, wrapped row, with Play and Print.
    • Spotlight, Siri and Shortcuts: say or search Play my year, Print my year or How was my year. That last one answers with your hours, your top app and your position; before 2 December, with how many days are left.

    The Wrapped page

    Until 2 December the sidebar's new Wrapped page is sealed: a countdown to the wrap and your days punched in, with nothing from inside, so the story stays a surprise. Siri and Spotlight count down too. From 2 December it has it all at once: your year punched day by day (click a day to open its card), your top apps, records, month by month, a typical day, your AI year and the annual card. Switch years at the top. If Timecard has only part of a year on file, it says so far or on file since… wherever it matters.

    Fixes

    • Shared cards no longer come out washed out. On macOS 26, images shared from Timecard could look grey when an app icon was on the card. They now save in true colour.

    Requirements

    Timecard still runs on macOS 14 and later. Everything in Wrapped works on every supported version. As always, nothing leaves your Mac.

  2. 2.2.1

    Gumroad keys

    Bought Timecard on Gumroad? Paste the licence key from your Gumroad receipt into Timecard and it unlocks, the same as a key from timecardmac.site.

    Each key works on one Mac. Moving to a new one? Click Remove from this Mac in Settings → Licence on the old Mac, then use the same key on the new one.

  3. In your language

    12 new languages

    Timecard now speaks Spanish, German, French, Portuguese (Brazil), Italian, Dutch, Japanese, Chinese (Simplified), Korean, Russian, Turkish and Polish. That covers every screen, the menu bar, alerts, notifications and your printed card, with dates and times in your region's format.

    It follows your Mac's language automatically. To pick another one just for Timecard, go to Settings → General → Language. Timecard restarts in the language you chose. Choose Match system to follow your Mac again.

    Briefs and Ask Timecard in your language

    Your daily brief and Ask Timecard's answers now come in your language too, whenever Apple Intelligence supports it on your Mac. Otherwise they stay in English.

  4. 2.1.6

    Anonymous usage counts, with an off switch

    Anonymous usage counts

    Timecard now sends a few anonymous counts, like "a card was printed" or "the AI page was opened", so I can see which features get used and where setup goes wrong. It never sends your apps, sites, times, AI usage or anything you type, and there's no ID that identifies your Mac. To stop it, turn off Settings → General → Share anonymous usage.

    Easier Full Disk Access setup

    Open Full Disk Access now brings the Finder window with Timecard to the front, so you can drag it straight into the list.

  5. 2.1.5

    Asks for its permissions again

    After 2.1.4's new signature, macOS kept showing Timecard's old permissions as on, but they had stopped working, and nothing asked you to fix them.

    • Your browser: Timecard now clears the old browser permission once, so macOS asks again. Click OK when it asks whether Timecard can control your browser. Browsers you open later ask the first time you use them.
    • Full Disk Access: If Timecard had it before and has lost it, an alert explains what to do and opens the right page in System Settings. Turn Timecard off and back on there.

    Your history, cards, limits and licence are untouched.

  6. 2.1.4

    A new signature

    Timecard is now signed by a new developer team. Nothing changes in the app, and updates keep arriving as before.

    Allow Timecard again, once

    macOS ties some permissions to the developer that signs an app, so after this update it may ask you to allow Timecard again:

    • Full Disk Access, for importing your Screen Time history and limits. Turn Timecard back on in System Settings → Privacy & Security → Full Disk Access.
    • Your browser, for website names and for blocking a site when a limit runs out. Click OK when macOS asks whether Timecard can control Safari, Chrome, Arc, Dia or another browser.

    Until you do, browsers count as one app instead of separate websites. Your history, cards, limits and licence are all untouched.

  7. 2.1.3

    One limit for your whole browser

    Limit a whole browser

    Set a daily limit on Safari, Chrome, Arc, Dia or another browser, and it now counts every site you visit in it, all together. Put two hours on your browser, and two hours of browsing is your day, whichever sites it went to. When it runs out, Timecard covers the browser. Limits on single sites still work inside it, and whichever runs out first applies.

    Smoother Timecards desk

    Flipping through your cards now glides: the card beside the one in your hand slides into place while the old one moves to the side. Dragging follows your hand too. Drag right to bring in the older card on the left, left for the newer one on the right. Cards are now in date order, so a card printed later for an earlier day sits with its neighbours.

    Fewer gaps in your day

    Timecard can only record your day while it's running, so it now tries harder to keep running:

    • Starts at login. After you restart your Mac, Timecard is already on the clock. It's switched on once with this update. If you'd rather start it yourself, turn it off in Settings → General → Start at login.
    • Asks before you quit. Quitting leaves a hole in your card, so Timecard offers Pause Tracking instead, which is usually what you want. Check Don't ask again to quit straight away in future. Restarts, log outs and updates never ask.

    If Timecard ever crashes

    The next time it opens, Timecard offers to send the crash report. Send Report… opens an email with the report attached, so you see exactly what's sent, and nothing goes until you press Send. Nothing about your day is in it.

    Fixes

    • Uses far less memory when reading your AI history. The first read after installing or updating used to climb past 350 MB for a minute. It now stays around 60 MB, which also leaves room for Apple Intelligence to keep answering.
    • Setting a limit from a row works again. The dim Limit button on an app or site without a limit no longer vanishes when you click it.
    • Importing Screen Time history again no longer loses older days. macOS only keeps about four weeks, and a second import used to replace everything it had brought in before, dropping days macOS had since forgotten. Now it only refreshes the weeks macOS still has, and it tells you how many sessions are actually new.
    • Screen Time history imports itself. If you skipped the import during setup, Timecard now brings in the weeks macOS kept as soon as you give it Full Disk Access, and lets you know. It only happens once. Before, it waited until you found the button, while macOS forgot a day for every day that passed.
    • Updates arrive sooner. Timecard now looks for an update as soon as it starts, say after you restart your Mac, not just once a day. It still installs updates by itself.
  8. 2.1.2

    Timecard 2.1.2

    No release notes were published for this version.

  9. 2.1.1

    Timecard 2.1.1

    No release notes were published for this version.

  10. 2.1.0

    Daily limits that hold

    Daily limits used to send a notice when your time ran out. Now they hold. When a limit runs out, Timecard blocks the app or site until you make a case for more, or until tomorrow.

    Easier to set

    Open Apps & Sites and click Limits at the top. Every limit is in one place, and you can add one for any app or site from there. Choose from 15 minutes to 4 hours, or set your own with Custom. Each limit also shows as a small chip on its row.

    Already set limits in Screen Time?

    Timecard picks them up for you, including limits synced from your iPhone. Change one in Screen Time and Timecard follows. Change one in Timecard and Timecard's own limit wins; Screen Time stays as it is, since Apple doesn't let other apps change it. Timecard needs Full Disk Access to read them.

    A nudge from the notch

    At 80%, a new alert comes out of the notch with how many minutes you have left, then tucks itself away.

    Time's up

    When a limit runs out, Timecard blocks it. A site's tab goes blank, and an app is covered with the time's-up screen. It works in Safari, Chrome, Arc, Dia, Brave, Edge, Vivaldi, Opera and Comet. Firefox isn't supported. Close the tab and you're done, or ask for more.

    Ask for time

    Tap Ask for time and say why you need it. Apple Intelligence reads your reason along with what the page is about, then decides:

    • "SwiftUI tutorial for a bug I'm fixing at work" gets you in for 10, 20 or 30 minutes, or a time you choose.
    • "Just one more video" gets a no, and you see when the limit resets.
    • A vague answer gets a follow-up question.

    It all happens on your Mac. Your reason never leaves it.

    Your rules

    Find these in Settings → Limits:

    • Block when time's up is on by default. Turn it off to get only the notch alerts.
    • Block Screen Time limits too: blocks limits picked up from Screen Time as well as your own. It's off by default, so those only get the notch alerts.
    • Pick a time instead of asking: skip the chat and choose a few minutes, or your own amount, right from the time's-up screen.
    • Offer "Ignore limit": adds a way past the block. You choose whether ignoring lasts the rest of the day, or 15 minutes to 2 hours (or your own time) before it blocks again.

    Also new

    • Smoother crank and sound when a limit runs out.
    • The Today and Apps & Sites headers fit narrow windows. The date filter moves under the title instead of squeezing it.

    Requirements

    Timecard still runs on macOS 14 and later. Ask for time needs macOS 26 with Apple Intelligence turned on. Without it, turn on Pick a time instead of asking to get extra time from the time's-up screen. Everything else works on every supported version.

  11. 2.0.1

    Ask your agents about your time

    Your coding agents can now read your Timecard. Ask Cursor, Claude or Codex things like "what was I doing around 2 yesterday?" or "which model do I use most?", and they answer from your own history.

    Connect an agent

    Open Settings and find Agents at the bottom.

    • Copy for Cursor or Claude, then paste it into Cursor, Claude Desktop, or Claude Code.
    • Copy for Codex, then paste it into Codex's config.

    Your licence on this Mac is enough. After that, an agent can ask as often as you like. Without a licence, it gets a paywall instead of your time.

    What they can answer

    • Screen time for today, yesterday, a week, a month, or any dates you name: categories, top apps and sites, punch in and out.
    • One app or site, including the hours you used it most and what's left of a daily limit.
    • Hour by hour, so you can see when you were on screen and when you were focused.
    • AI coding: time, tokens, cost, projects, models, and how close you are to a Claude or Codex limit.

    Nothing is sent anywhere. Timecard only reads what's already on your Mac, and it gives agents the numbers, not the text of your chats.

  12. 2.0

    Your AI gets a timecard too

    The biggest update since launch, and it's free for everyone who already has Timecard.

    A new AI page

    Timecard now reads the history your AI coding tools keep on your Mac: Claude Code, Codex, Cursor, opencode and Gemini CLI. Open AI in the sidebar to see:

    • Plan limits: how much of each Claude and Codex limit you've used, and when it resets.
    • Your time and tokens: time with AI, tokens, and your streak, by day and by tool.
    • Projects, models and recent sessions, for any range you like, with the same date picker as Today.

    Nothing is sent anywhere. Timecard only reads files that are already on your Mac.

    What your plan is really worth

    The API value tile shows what the same work would cost at the API's list prices, worked out request by request, next to what your plan costs for those days. For example: "8.5× your Max 5x for these days". Timecard detects your Claude and Codex plans. If you pay a different price, set it in Settings → AI.

    Your agents' timecard

    When you step away, your agents keep going. A new card on the AI page shows when your agents were working, next to when you were, and how much of their time was while you were away.

    Ask Timecard

    Ask anything about your time, like "Where did today go?" or "How much did I code with AI this week?", and get answers from your own Timecard history. Press ⌘J on any screen. Apple Intelligence works it out on your Mac.

    Smarter everywhere

    • Daily brief: Today and Week open with two sentences on where the time went.
    • Sort with AI: on Apps & Sites, files apps and sites that are still under Other in one click. You can re-file any of them.

    Alerts and limits

    • Limit alerts: a notification at 80% and 95% of a Claude or Codex limit, and when it resets. You can turn them off in Settings → AI.
    • Daily limits for apps and sites: pick an app in Apps & Sites and set a limit, from 15 minutes to 4 hours. You'll get a nudge at 80% and a notice when the time runs out.
    • AI in the menu bar: today's AI time, and the limit you're closest to.

    macOS asks once for permission to show Timecard's notifications.

    Also new

    • A new AI icon: a clock dial that talks. Its hand sweeps while it's thinking.
    • Today has a new sidebar icon.

    Fixes

    • More accurate AI numbers. Resuming or forking a Claude Code session copies earlier messages into a new file, and those were counted twice. AI tokens and time are now counted once, so expect your totals to be about 20% lower than before.
    • History that lasts. Timecard keeps your AI history even after Claude Code deletes old transcripts, which it does after 30 days.
    • A one-time read after updating. The first launch reads your AI history once, which takes about a minute in the background.

    Requirements

    Timecard still runs on macOS 14 and later. Ask Timecard, daily briefs and Sort with AI need macOS 26 with Apple Intelligence turned on. Everything else works on every supported version.

  13. 1.0.4

    Timecard 1.0.4

    Your timecards, laid out on a desk

    The Timecards screen got a makeover. Yesterday's card now lies beside the one in your hand, and tonight's card waits in an empty slot until it prints. Along the bottom, a punch-clock rack holds every card you've printed, with the date and that day's screen time on each stub. Click any stub to jump straight to it.

    A new day starts at midnight

    Timecard now begins a new day at midnight, the same as Screen Time, so after 12 AM you're looking at today, not yesterday.

    If you often work past midnight and want those hours on the day before, go to Settings → Day ends at and pick 1–6 AM. When a day runs past midnight, the Today header says so.

    Fixes

    • The arrows on the Timecards screen now match the arrow keys: left for older cards, right for newer.
  14. 1.0.3

    Timecard 1.0.3

    Tooltips always on top

    Chart tooltips now float above everything around them. The week chart's average line, neighbouring bars and the rows below no longer cut through them.

    Fixes

    • The "Last 30 days" tooltip on an app or site stays inside the panel, even on today's bar at the edge.
    • More room around the licence key field when you unlock, so the field, the hint and the step dots no longer crowd each other.
  15. 1.0.2

    Timecard 1.0.2

    Updates take care of themselves

    Timecard now downloads updates in the background and installs them while its window is closed. It's back in about two seconds and keeps tracking, so you're always on the latest version without clicking anything.

    Lives in Applications

    If you open Timecard from your Downloads folder, it offers to move itself into Applications. Updates can only install from there.

    Easier to find on the printed card

    Share and Close now sit in a clear bar under the card, next to the tear-off hint, instead of as small icons beside it.

    Fixes

    • The menu bar no longer goes blank when you click into Timecard.
    • Closing the window removes Timecard from the Dock. It keeps running in the menu bar, one click away.
    • Day-strip tooltips stay inside the menu bar panel, even at the edges.

    Also

    • Made by Prince Ajuzie. Say hi on X or LinkedIn, linked from Settings.
  16. 1.0.1

    Timecard 1.0.1

    No release notes were published for this version.

  17. 1.0

    First release

    The first public release of Timecard for Mac.