AI Usage 0.1.2 — automatic welcome flow

The welcome questionnaire now appears automatically when AI Usage first launches. People no longer have to find a feedback link or click the menu bar to see it.

Download

Download AI Usage 0.1.2 (.dmg) — macOS 13+, universal Apple Silicon and Intel. ZIP and checksums are also attached.

Quit AI Usage before replacing it. Drag the new app to Applications and reopen it. History is preserved. Earlier versions do not update automatically.

What's new

• Welcome to AI Usage appears on first launch, with the existing three optional questions.
• Skip and start opens the dashboard without submitting anything.
• Send and start opens the dashboard after the service confirms your answers were saved. If sending fails, you can retry or skip.
• Existing users see this new welcome once after updating; it does not repeat on subsequent launches.
• Settings still lets you reopen feedback later and now includes Contact us · keith@rumjahn.com.

Answers are stored privately in Cloudflare D1, with daily cleanup after 90 days. Activity history stays local. The collector, classification rules, analytics and activity database are unchanged.

Validation and limitations

All 26 macOS tests passed, including new onboarding lifecycle and submission-result tests. The universal Release build, strict app signature verification and DMG integrity checks passed. In the actual app, first launch displayed the welcome without a menu-bar click; Skip opened the dashboard; restarting did not repeat it. Existing closed history records matched the read-only baseline. The send-to-dashboard and failure paths were tested with a controlled transport; the unchanged live transport was verified in 0.1.1.

This is an ad-hoc signed, unnotarized developer preview. macOS may block downloaded builds. See installation instructions. Runtime verification used Apple Silicon; Intel/macOS 13 hardware was not tested. Closing the welcome window also dismisses the offer.

See the welcome screen · Detailed changes and verification

AI Usage 0.1.1 — optional onboarding

AI Usage now includes a working, optional three-question onboarding form to help guide development. Your activity history stays on your Mac.

Download

• Universal macOS DMG — macOS 13+, Apple Silicon and Intel.
• ZIP alternative and SHA256SUMS.txt are attached below.

Quit AI Usage, open the DMG, drag AI Usage.app to Applications, and reopen it. The bundle identifier and data directory are unchanged, so upgrading preserves history. Earlier builds do not update automatically.

What changed

• Three optional questions appear once when you first open the dashboard. Skip sends nothing.
• Reopen the questionnaire from Settings → Help shape AI Usage.
• Explicitly submitted answers are saved privately in Cloudflare D1, with a daily cleanup of responses older than 90 days.
• No activity history, prompts, page contents, provider credentials, account or email fields are included. Only answers, app version, schema version and a random submission ID are sent.
• The feedback API runs on Cloudflare's Free plan; the marketing website remains deferred. No account or payment is required to use AI Usage.

Validation

24 macOS tests and 6 backend tests passed, along with type checking and a universal release build. The live app's Skip, Settings, Send, Done and restart behavior were checked. A labelled test response was verified in D1, then removed. Existing closed activity history matched the pre-upgrade baseline. DMG integrity, app signatures, architectures and bundled file hashes were verified.

This remains an ad-hoc signed, unnotarized developer preview. macOS may block it. Follow installation instructions only if you trust the project; do not disable Gatekeeper system-wide. Runtime testing used Apple Silicon, not Intel hardware. The retention job is scheduled and unit-tested; a 90-day production interval has not yet elapsed.

Watch the demo

ai-usage-laptop-preview.mp4

The demo uses illustrative data. AI Usage measures active foreground attention across desktop and web, not token allowances or productivity.

AI Usage 0.1.0 — macOS DMG preview

Download for macOS

Download AI Usage 0.1.0 (.dmg) — macOS 13+, Apple Silicon and Intel in one universal app.

1. Open the DMG.
2. Drag AI Usage.app to Applications. Quit any previous AI Usage instance first.
3. Eject the disk image, open AI Usage from Applications, and click the time in your menu bar.

Unnotarized developer preview: this app is ad-hoc signed, not Developer ID signed or notarized. macOS may block it. If you trust the project, follow Apple's per-app approval instructions, or build from source. Do not disable Gatekeeper system-wide. Full installation and browser-permission details are in INSTALL.md.

Watch the menu-bar demo

ai-usage-laptop-preview.mp4

Download the 8-second MP4. Actual app interface with labeled sample data, a staged MacBook, and subtle sound effects. Asset credits.

Included

• Compact native menu-bar dashboard with today's and the past seven days' AI foreground attention.
• Desktop and recognized website time combined per tool, with a minimal Web / Desktop split.
• Opt-in browser identification, local SQLite history, pause, export and delete controls.
• MIT source, screenshots with sample records, and a menu-bar interaction demo.

This tracks foreground attention, not tokens, subscription allowances or background agents. The optional feedback service is unconnected, so automatic onboarding is disabled. No account or provider credentials are required.

Packaging update

The new DMG contains the same app as the original ZIP; there are no application-code or database changes. It adds an Applications shortcut, a compact Finder layout, and installation notes. Your existing history is preserved when replacing the app. The ZIP remains available as an alternative.

Compare your download's SHA-256 with SHA256SUMS.txt. Both DMG and ZIP checksums are included.

Validation

• Previously tested app: 24 macOS tests and six feedback API tests passed; universal Release build verified.
• DMG: disk-image checksum verified; mounted read-only; app signature verified; all app file hashes match the ZIP; temporary installation copy verified; Applications link and Finder presentation checked.
• Application tests were not rerun for this packaging-only update. No collector was launched during packaging, and the installed app and activity history were not changed.

Remaining limitations: no Developer ID notarization; no clean-machine Gatekeeper installation test; Intel/macOS 13 runtime and Cloudflare production feedback remain untested.